よくある質問
NanoClaw の仕組みに関するよくある質問。
NanoClaw は Anthropic Claude Agent SDK 上に構築された軽量オープンソースのパーソナルAIアシスタントです。エージェントは隔離された Linux コンテナ(macOS では Apple Container、macOS/Linux では Docker)で実行されます。WhatsApp 標準搭載、その他のチャネルはスキルで追加。永続 SQLite メモリ、スケジュールタスク、ウェブアクセス、ブラウザ自動化、エージェント群を搭載。
'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' を実行し、Claude セッション内で /setup を使用してください。Claude Code が依存関係、認証、コンテナセットアップ、サービス設定を処理します。Node.js 20+ と Claude Code が必要です。
NanoClaw は理解できるほど小さい — プロセスひとつ、ソースファイル数個、マイクロサービスなし。肥大化したフレームワークとは異なり、コードベース全体を読めます。エージェントはアプリケーションレベルの権限チェックではなく、ファイルシステム隔離を備えた本物の Linux コンテナで実行されます。
NanoClaw は Anthropic Claude Agent SDK 上でのみ動作します。Claude Code が各コンテナ内にグローバルインストールされ、すべてのAI処理を担当します。SDK がモデル選択を内部的に管理 — NanoClaw は設計上単一プロバイダーです。
WhatsApp が標準搭載チャネルです(Baileys ライブラリ経由、QRコードペアリング)。Telegram、Discord、Slack は Claude Code スキルで追加可能 — /add-telegram、/add-discord、/add-slack を実行してください。スキルがフォークのソースコードを変更し、クリーンで専用のチャネルサポートを追加します。
セキュリティは設計の核心です。エージェントはアプリケーションレベルの権限チェックではなく、ファイルシステム隔離を備えた Linux コンテナ(macOS では Apple Container、macOS/Linux では Docker)で実行されます。シークレットは stdin JSON 経由で渡され、process.env には読み込まれません。シンボリックリンク脱出検知付きマウント許可リスト。コンテナは非 root ユーザーで実行、プロジェクトソースは読み取り専用マウント。
NanoClaw は永続ストレージに SQLite(better-sqlite3)を使用 — メッセージ、グループ、セッション、スケジュールタスク、ルーター状態。各グループにはコンテナにマウントされる独自の CLAUDE.md ファイルもあります。外部データベース不要。
はい。NanoClaw は macOS と Linux で動作します — Node.js 20+ と Docker が動作する環境ならどこでも。軽量 TypeScript コアは Raspberry Pi を含む低リソースデバイスでも動作します。コンテナランタイム(Apple Container または Docker)と Anthropic API キーが必要です。
エージェント群は、複雑なタスクで協力する専門エージェントチームを NanoClaw が起動する機能です。NanoClaw は Claude Code の agent-teams 機能を活用した、エージェント群をサポートする初のパーソナルAIアシスタントです。
プロジェクトは github.com/qwibitai/nanoclaw で MIT ライセンスのオープンソースです。貢献ガイドラインは README をご確認ください。すべての貢献を歓迎します。
組み込みツールはコンテナ内で実行される Claude Code が提供:シェルコマンド、ファイル読み書き、ウェブ検索、ウェブブラウジング(Chromium)、エージェント委任(群)。ホストプロセスはスケジュールタスク(cron)、永続 SQLite メモリ、WhatsApp メッセージングを提供。スキルの追加で機能を拡張できます。
はい。各エージェントコンテナには Chromium と agent-browser がインストールされています。Claude Code はサンドボックス化されたコンテナ内でウェブ検索やページ閲覧を行い、リアルタイム情報を取得できます。
公式かつ唯一の信頼できるリポジトリは github.com/qwibitai/nanoclaw です。コミュニティ Discord は discord.gg/VDdww8qS42 です。
macOS と Linux。Node.js 20+ とコンテナランタイム — macOS では Apple Container、macOS/Linux では Docker が必要です。Windows は公式サポート対象外ですが、WSL2 と Docker 経由で動作する可能性があります。
NanoClaw は Claude Agent SDK 経由で Anthropic Claude のみを使用します。.env ファイルに ANTHROPIC_API_KEY を設定するか、Claude Code OAuth で認証してください。マルチプロバイダーサポートはありません — SDK がモデル選択を内部的に処理します。
GitHub リポジトリ(github.com/qwibitai/nanoclaw)の README が主要なドキュメントです。docs/ ディレクトリにはアーキテクチャ仕様、セキュリティモデル、デバッグチェックリストがあります。コードベースは小さいので、Claude Code に案内を頼むこともできます。
公式チャネル:Discord(discord.gg/VDdww8qS42)と GitHub(github.com/qwibitai/nanoclaw)。すべてのコミュニティリンクは README をご確認ください。