nanocoai/nanoclaw

NanoClaw – 安全でコンテナ分離されたAIアシスタント

概要

• AIエージェント（Claude、OpenAI、Ollamaなど）を個別のDockerコンテナ内で実行できるオープンソースフレームワークです。各エージェントは独自ファイルシステム、メモリ、認証情報を持ち、ホストマシンはモデルの実行環境から分離されます。
• 小さく理解しやすい設計：単一のNode.jsプロセスがすべてをオーケストレーションし、コアコードは少数のファイルに収められています。

主な機能

機能	内容
エージェントごとのコンテナ分離	各エージェントは独自のLinuxコンテナ内で実行され、明示的にマウントしたディレクトリのみが可視化されます。
マルチチャネルメッセージング	Slack、Discord、Telegram、WhatsApp、iMessage、Microsoft Teams、Matrix、Google Chat、Webex、Linear、GitHub、WeChat、メール（Resend経由）、およびローカルCLI用の組み込みアダプター。/add-<channel> スキルで新しいアダプターをオンデマンドで追加可能です。
認証ゲートウェイ	APIキーがコンテナに触れることはありません。アウトバウンドリクエストは認証ゲートウェイサービス（デフォルトはOneCLIのAgent Vault）を介してプロキシされ、エージェントごとに適切なシークレットを注入し、レート制限を適用します。
エージェントテンプレート	templates/ または公開テンプレートライブラリに保存されたテンプレートから、すぐに実行可能なエージェントを素早く立ち上げます。
スケジュールタスク	定期的なジョブ（例：毎日のブリーフィング）を定義し、コンテナが必要な時にのみ実行します。スクリプトゲートによる保護も可能です。
ハイブリッドAIネイティブワークフロー	インストールとエラー復旧はスクリプト化されていますが、判断が必要なステップではシステムがClaude Code（Anthropicの「コードアシスタント」）に引き継ぎ、自動的に診断と継続を行います。
ゼロコンフィグカスタマイズ	巨大な設定ファイルを編集する代わりに、Claude Codeにやりたいこと（例：トリガーワードの変更）を伝えると、ソースコードをパッチしてくれます。
クロスモデルサポート	Claudeがデフォルトのプロバイダーですが、簡単な /add-<provider> コマンドでOpenAI Codex、OpenCode経由のOpenRouter、CursorのローカルSDK、または任意のOllamaモデルを追加できます。

インストールとクイックスタート

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh   # Node、pnpm、Dockerのインストール（必要な場合）、Anthropic認証情報の登録、最初のエージェントコンテナのビルド、チャネル（Slack、Telegramなど）のペアリングを行います

スクリプトが各ステップを案内します。失敗した場合はClaude Codeが自動的に呼び出され、デバッグと再開を行います。

エージェントとの対話方法

• トリガーワード（デフォルトは @Andy）を選択します。
• 接続されたチャネルで自然言語コマンドを送信します。例：

  @Andy send an overview of the sales pipeline every weekday morning at 9 am (has access to my Obsidian vault folder)
  @Andy review the git history for the past week each Friday and update the README if there’s drift
  

• @Andy list all scheduled tasks や @Andy join the Family Chat group のようなチャットコマンドで、グループ、タスク、チャネル接続を管理します。

NanoClawの拡張

• スキル (Skills) – 新機能はコア機能ではなくスキルとして追加されます。スキルは独自のフォルダ (payload/) に存在し、スラッシュコマンド (/add-telegram, /add-opencode など) でインストールされます。
• チャネル (Channels) – チャネルアダプターは専用の channels ブランチに存在します。リポジトリをフォークし、カスタムアダプターを追加して、自分のインストール環境にコピーできます。
• プロバイダー (Providers) – 代替のLLMバックエンドも同様の方法で追加され、メインのコードベースを最小限に保ちます。

セキュリティモデル

• OSレベルの分離 – Dockerコンテナにより、各エージェントは独自のPID、ネットワーク名前空間、ファイルシステムビューを持ちます。
• 認証情報の取り扱い – シークレットはホスト上にのみ保存され、リクエスト時に認証ゲートウェイによって注入されます。コンテナが生のキーを見ることはありません。
• ユーザーアカウントなし – NanoClawはクラウドアカウントを作成しません。唯一のアウトバウンド接続は、特典（例：強化されたビルド済みイメージや管理されたSlackアプリ）のためのオプションのコミュニティポータルへの接続です。すべての診断は匿名であり、NANOCLAW_NO_DIAGNOSTICS=1 で無効化できます。

典型的なユースケース

• プライベートな保管庫内のファイルの読み書き、レポートのスケジュール、バージョン管理との対話が可能な個人生産性アシスタント。
• APIキーを公開せずにウェブブラウジング、データ取得、ユーザーの代理実行が可能な、安全なセルフホスト型チャットボット。
• 各チームメンバーが分離されたエージェントを持ちつつ、共通のチャネル（例：Slackワークスペース）を共有するマルチユーザーチームボット。
• 実行環境を同一に保ちながら、異なるLLMプロバイダーを試すための実験プラットフォーム。

コミュニティとサポート

• Discordコミュニティ: https://discord.gg/VDdww8qS42
• ドキュメントサイト: https://docs.nanoclaw.dev
• 公開テンプレートライブラリ: https://github.com/nanocoai/nanoclaw-templates

ライセンス

• MIT – 個人、学術、商用利用は無料。

---

NanoClawは、巨大なモノリシックなコードベースを扱うことなく、理解、監査、調整が可能な、透明でコンテナ分離されたAIアシスタントをパワーユーザーに提供することを目指しています。