NanoClaw：コンテナ内でエージェントを実行する軽量AIアシスタント

nanoclawで確認するプロジェクトの背景と位置づけ

READMEは著者の個人的な理由から始まります。OpenClawは印象的だが、理解できない複雑なソフトウェアに自分の生活への完全なアクセスを与えることはできないと述べ、約50万行のコード、53の設定ファイル、70以上の依存関係、アプリケーションレベルのセキュリティ（許可リストやペアリングコード）を挙げています。NanoClawは同じようなコア機能を、理解できる規模のコードベースで提供し、エージェントをLinuxコンテナ内で実行します。リポジトリの説明では、セキュリティのためにコンテナで実行されるOpenClawの軽量な代替品であり、WhatsApp、Telegram、Slack、Discord、Gmailなどのメッセージングアプリに接続し、メモリ、スケジュールジョブ、AnthropicのAgents SDKとの直接統合を備えています。

nanocoai/nanoclawの第1節で見る対象は「プロジェクトの背景と位置づけ」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節の確認では、機能の存在と運用上の適合性を別々に判断します。

nanoclawで確認するインストールと移行

クイックスタートは3つのコマンドです。リポジトリをクローンし、ディレクトリに入り、bash nanoclaw.shを実行します。READMEによると、このスクリプトはNode、pnpm、Dockerがなければインストールし、Anthropicの認証情報をOneCLIに登録し、エージェントコンテナをビルドし、最初のチャンネル（iMessage、Telegram、Discord、WhatsApp、またはローカルCLI）をペアリングします。ステップが失敗した場合、Claude Codeが自動的に呼び出され、診断と再開が行われます。v1からの移行にはmigrate-v2.shスクリプトがあり、.env、データベース、セッション、スケジュールタスク、チャンネル認証状態をv2チェックアウトに移行しますが、システムサービスを自動的に切り替えることはありません。

nanocoai/nanoclawの第2節で見る対象は「インストールと移行」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節に関する性能や互換性は、READMEが明記していない限り確認済みの事実として扱えません。

nanoclawで確認する設計思想：小規模、分離、カスタマイズ可能

プロジェクトの哲学はいくつかのポイントにまとめられています。コードベースは完全に理解できるほど小さいことを意図しており、1つのプロセス、少数のソースファイル、マイクロサービスなしです。セキュリティは分離によってもたらされ、エージェントはLinuxコンテナ内で実行され、明示的にマウントされたディレクトリだけを参照できます。プロジェクトは個人ユーザー向けであり、モノリシックなフレームワークではなく、設定ファイルを追加するのではなくコードを変更することでカスタマイズします。READMEはスキル優先モデルを紹介しています。トランクはレジストリとインフラストラクチャを提供し、チャンネルアダプタはchannelsブランチ、代替プロバイダはprovidersブランチに置かれ、ユーザーは/add-telegramなどのコマンドで必要なモジュールをフォークにコピーします。

nanocoai/nanoclawの第3節で見る対象は「設計思想：小規模、分離、カスタマイズ可能」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節の確認では、機能の存在と運用上の適合性を別々に判断します。

nanoclawで確認するサポートされる機能と分離モデル

READMEは、WhatsApp、Telegram、Discord、Slack、Microsoft Teams、iMessage、Matrix、Google Chat、Webex、Linear、GitHub、WeChat、Resend経由のメールなど、複数のチャンネルをリストしています。各エージェントグループには独自のCLAUDE.md、メモリ、コンテナ、そして許可されたマウントだけがあります。スケジュールタスクは繰り返しジョブを実行でき、作業がないときにエージェントを起動しないようにスクリプトゲートを設定できます。ウェブアクセス（検索と取得）も含まれます。分離モデルには3つの構成があります。チャンネルごとにエージェントを分ける、複数チャンネルで1つのエージェントを共有する、複数チャンネルを1つの共有セッションにまとめる、です。認証情報はコンテナ内に保持されず、送信リクエストはOneCLIのAgent Vaultを経由し、リクエスト時に認証情報を注入し、エージェントごとのポリシーとレート制限を適用します。

nanocoai/nanoclawの第4節で見る対象は「サポートされる機能と分離モデル」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節に関する性能や互換性は、READMEが明記していない限り確認済みの事実として扱えません。

nanoclawで確認するアカウントとデータの境界

NanoClawにはユーザーアカウントはありません。READMEによると、報告されるのは匿名のセットアップ診断情報のみで、NANOCLAW_NO_DIAGNOSTICS=1を設定すると無効になります。エージェント、メッセージ、ファイル、キーはデフォルトでユーザーのマシンから出ることはありません。唯一のオプトイン例外は、プリビルドされたエージェントイメージを取得することです。これには無料アカウントが必要で、メールアドレスとイメージをリクエストした時刻が共有されますが、エージェントに関する情報は共有されず、イメージが配信された後は何も共有されません。ローカルビルドがデフォルトで、アカウントや外部連絡は不要です。

nanocoai/nanoclawの第5節で見る対象は「アカウントとデータの境界」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節の確認では、機能の存在と運用上の適合性を別々に判断します。

nanoclawで確認する使用方法とカスタマイズ

日常的な使用では、デフォルトで@Andyというトリガーワードでアシスタントに話しかけます。READMEの例には、毎週平日の朝9時に営業パイプラインの概要を送信する、毎週金曜日にgit履歴をレビューする、月曜日の朝にニュースブリーフィングをまとめるなどがあります。ユーザーはすべてのスケジュールタスクを一覧表示したり、タスクを一時停止したりと、グループとタスクを直接管理できます。カスタマイズは設定ファイルを使わず、Claude Codeに変更したいことを伝えます。例えばトリガーワードを変更したり、返答を短くしたりします。/customizeコマンドでガイド付きの変更ができます。デバッグも対話的で、「スケジューラーが動いていないのはなぜ？」といった質問をClaude Codeに投げます。

nanocoai/nanoclawの第6節で見る対象は「使用方法とカスタマイズ」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節に関する性能や互換性は、READMEが明記していない限り確認済みの事実として扱えません。

nanoclawで確認するアーキテクチャと主要ファイル

READMEはデータフローを示しています。メッセージアプリはホストプロセスにメッセージを送信し、ルーターはエンティティモデルに従ってセッションのinbound.dbに書き込み、コンテナを起動します。コンテナ内のエージェントランナーはinbound.dbをポーリングし、エージェントを実行し、応答をoutbound.dbに書き込みます。ホストはoutbound.dbをポーリングし、チャンネルアダプタを通じて配信します。各セッションには2つのSQLiteファイルがあり、それぞれ書き込み元は1つだけで、クロスマウントの競合を避けます。主要ファイルとして、src/index.ts（エントリポイント）、src/router.ts（受信ルーティング）、src/delivery.ts（送信配信）、src/host-sweep.ts（60秒スイープ）、src/container-runner.ts（コンテナ起動と認証情報注入）、container/agent-runnerディレクトリ（BunとClaude Agent SDK）がリストされています。

nanocoai/nanoclawの第7節で見る対象は「アーキテクチャと主要ファイル」です。READMEに書かれた操作と未記載の条件を分け、nanoclawの版、入力、出力、設定ファイルを固定してください。本文に出てくるコマンドを一つずつ実行し、説明どおりの状態になるかを記録します。この節の確認では、機能の存在と運用上の適合性を別々に判断します。

編集部の結論

NanoClawのREADMEは、小さなコードベース、コンテナベースの分離、スキル駆動の拡張モデルを強調しています。パフォーマンスベンチマーク、ユーザー数、本番環境の検証データは含まれておらず、それらは検証すべき項目です。 nanocoai/nanoclawが向くのは、READMEに示された環境と手順を管理できる利用者です。導入前にnanoclawのリリース版を固定し、README記載の入口を隔離した作業ディレクトリで試し、設定ファイルと実行ログを照合してください。性能、互換性、長期運用の保証は本文の事実からは判断できないため、確認できた範囲だけを採用対象にしてください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes