NanoClaw を起動する
軽量 TypeScript コア、インストール方法はひとつ。クローン、claude を実行、/setup を使用。
checklist システム要件
Node.js 20+(LTS 推奨)
macOS または Linux。Windows は WSL2 経由で動作する可能性がありますが、公式サポート対象外です。
512MB 以上の RAM。軽量ランタイム、重いコンパイルなし。
インストール時 約50MB(node_modules)。コンテナイメージで約500MB 追加。
必須:Apple Container(macOS)または Docker(macOS/Linux)。必須:Claude Code CLI。
Anthropic API 呼び出しにインターネット接続が必要。オフラインモードなし。
リポジトリをクローンして Claude CLI で開始。数分で起動できます。
One-Liner
Requires Claude CLI. All platforms.
git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude Step-by-Step
Clone first, then configure. More control.
git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw && npm install # Run claude and use /setup for guided configuration # Or edit .env and src/index.ts directly verified インストールの確認
以下のコマンドを実行して NanoClaw が正しくインストールされたことを確認してください。
node -e "console.log(require('./package.json').version)" インストールされたバージョン番号が表示されます。
npm test テストスイート(vitest)を実行して依存関係とコア機能を検証します。
claude Claude Code を開きます。セッション内で /setup を実行してガイド付き設定を行います。
settings 初期設定
Claude Code が /setup でセットアップを処理します。設定内容は以下の通りです。
依存関係のインストール
Claude Code が npm install を実行し、Chromium、agent-browser、Claude Code がプリインストールされたコンテナイメージ(nanoclaw-agent:latest)をビルドします。
認証
.env に ANTHROPIC_API_KEY を設定するか、Claude Code OAuth で認証します。シークレットは実行時にコンテナに渡され、process.env には読み込まれません。
WhatsApp 接続
'npm run auth' を実行してQRコードでペアリング。WhatsApp は標準搭載チャネルです。後からスキル(/add-telegram、/add-discord、/add-slack)で Telegram、Discord、Slack を追加できます。
エージェントの起動
'npm start' を実行して NanoClaw を起動。WhatsApp に接続し、メッセージポーリングループを開始し、隔離コンテナでメッセージの処理を開始します。
.env — NanoClaw は設定ファイルを使用しません。変更するには Claude Code に要望を伝えてください。コードベースは Claude が安全に変更できるほど小さいです。
system_update_alt NanoClaw のアップグレード
最新の機能、連携、セキュリティパッチを入手するために NanoClaw を最新に保ちましょう。
cd NanoClaw && git pull && npm install cd NanoClaw && git pull && docker compose up --build 各バージョンの変更点は github.com/qwibitai/nanoclaw/releases のチェンジログをご確認ください。
build トラブルシューティング
よくある問題とその解決方法。