啟動 NanoClaw
輕量 TypeScript 核心，單一安裝路徑。複製、執行 claude、使用 /setup。
checklist 系統需求
Node.js 20+（建議使用 LTS 版本）
macOS 或 Linux。Windows 透過 WSL2 可能可用，但非官方支援。
512MB+ 記憶體。輕量執行環境，無需大量編譯。
安裝約 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 並建構容器映像（nanoclaw-agent:latest），預裝 Chromium、agent-browser 和 Claude Code。
驗證
在 .env 中設定 ANTHROPIC_API_KEY，或透過 Claude Code OAuth 驗證。密鑰在執行時傳遞給容器，絕不載入 process.env。
連接 WhatsApp
執行 'npm run auth' 透過 QR code 配對。WhatsApp 是內建頻道。之後可透過技能新增 Telegram、Discord 或 Slack（/add-telegram、/add-discord、/add-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 疑難排解
常見問題與解決方法。