インストールガイド

NanoClaw を起動する

軽量 TypeScript コア、インストール方法はひとつ。クローン、claude を実行、/setup を使用。

checklist システム要件

javascript Node.js

Node.js 20+(LTS 推奨)

computer OS

macOS または Linux。Windows は WSL2 経由で動作する可能性がありますが、公式サポート対象外です。

memory RAM

512MB 以上の RAM。軽量ランタイム、重いコンパイルなし。

hard_drive Disk

インストール時 約50MB(node_modules)。コンテナイメージで約500MB 追加。

extension Optional

必須:Apple Container(macOS)または Docker(macOS/Linux)。必須:Claude Code CLI。

wifi Network

Anthropic API 呼び出しにインターネット接続が必要。オフラインモードなし。

リポジトリをクローンして Claude CLI で開始。数分で起動できます。

bolt

One-Liner

Requires Claude CLI. All platforms.

$ git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude
list_alt

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 が正しくインストールされたことを確認してください。

1
$ node -e "console.log(require('./package.json').version)"

インストールされたバージョン番号が表示されます。

2
$ npm test

テストスイート(vitest)を実行して依存関係とコア機能を検証します。

3
$ claude

Claude Code を開きます。セッション内で /setup を実行してガイド付き設定を行います。

settings 初期設定

Claude Code が /setup でセットアップを処理します。設定内容は以下の通りです。

1

依存関係のインストール

Claude Code が npm install を実行し、Chromium、agent-browser、Claude Code がプリインストールされたコンテナイメージ(nanoclaw-agent:latest)をビルドします。

2

認証

.env に ANTHROPIC_API_KEY を設定するか、Claude Code OAuth で認証します。シークレットは実行時にコンテナに渡され、process.env には読み込まれません。

3

WhatsApp 接続

'npm run auth' を実行してQRコードでペアリング。WhatsApp は標準搭載チャネルです。後からスキル(/add-telegram、/add-discord、/add-slack)で Telegram、Discord、Slack を追加できます。

4

エージェントの起動

'npm start' を実行して NanoClaw を起動。WhatsApp に接続し、メッセージポーリングループを開始し、隔離コンテナでメッセージの処理を開始します。

.env — NanoClaw は設定ファイルを使用しません。変更するには Claude Code に要望を伝えてください。コードベースは Claude が安全に変更できるほど小さいです。

system_update_alt NanoClaw のアップグレード

最新の機能、連携、セキュリティパッチを入手するために NanoClaw を最新に保ちましょう。

Git + npm
$ cd NanoClaw && git pull && npm install
Docker
$ cd NanoClaw && git pull && docker compose up --build

各バージョンの変更点は github.com/qwibitai/nanoclaw/releases のチェンジログをご確認ください。

build トラブルシューティング

よくある問題とその解決方法。

お困りですか?

インストールサポートやトラブルシューティングはコミュニティにご参加ください。

最新情報を受け取る

新リリース、連携機能、NanoClaw の開発状況をお届けします。スパムなし、いつでも解除可能。