常見問題
關於 NanoClaw 及其運作方式的常見問題。
NanoClaw 是一個輕量、開源的個人 AI 助理,基於 Anthropic Claude Agent SDK 打造。代理在隔離的 Linux 容器中運行(macOS 使用 Apple Container,macOS/Linux 使用 Docker)。內建 WhatsApp,其他頻道透過技能新增。具備持久 SQLite 記憶、排程任務、網頁存取、瀏覽器自動化和代理群集。
執行 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' 並在 Claude 工作階段中使用 /setup。Claude Code 處理相依套件、驗證、容器設定和服務設定。需要 Node.js 20+ 和 Claude Code。
NanoClaw 小巧到一目了然 — 單一程序、幾個原始碼檔案、沒有微服務。不像臃腫的框架,你可以讀完整個程式碼庫。代理在真正的 Linux 容器中運行,使用檔案系統隔離,而非應用程式層級的權限檢查。
NanoClaw 完全基於 Anthropic Claude Agent SDK 運行。Claude Code 全域安裝在每個容器內,處理所有 AI 互動。SDK 內部管理模型選擇 — NanoClaw 設計上僅使用單一供應商。
WhatsApp 是內建頻道(透過 Baileys 函式庫,QR code 配對)。Telegram、Discord 和 Slack 可透過 Claude Code 技能新增 — 執行 /add-telegram、/add-discord 或 /add-slack。技能會修改你 fork 的原始碼以新增乾淨、專用的頻道支援。
安全性是核心設計原則。代理在 Linux 容器中運行(macOS 使用 Apple Container,macOS/Linux 使用 Docker),使用檔案系統隔離 — 而非應用程式層級的權限檢查。密鑰透過 stdin JSON 傳遞,絕不載入 process.env。掛載允許清單搭配符號連結逃逸偵測。容器以非 root 使用者運行,專案原始碼以唯讀方式掛載。
NanoClaw 使用 SQLite(better-sqlite3)進行持久儲存 — 訊息、群組、工作階段、排程任務和路由狀態。每個群組也有自己的 CLAUDE.md 檔案作為群組記憶,掛載到其容器中。不需要外部資料庫。
可以。NanoClaw 在 macOS 和 Linux 上運行 — 任何能運行 Node.js 20+ 和 Docker 的地方。輕量 TypeScript 核心可在低資源裝置上運行,包括 Raspberry Pi。需要容器執行環境(Apple Container 或 Docker)和 Anthropic API 金鑰。
代理群集讓 NanoClaw 啟動專業代理團隊協作處理複雜任務。NanoClaw 是首個支援代理群集的個人 AI 助理,基於 Claude Code 的 agent-teams 功能打造。
專案在 github.com/qwibitai/nanoclaw 以 MIT 授權開源。查看 README 了解貢獻指南。歡迎所有貢獻。
內建工具由容器內運行的 Claude Code 提供:shell 指令、檔案讀寫、網頁搜尋、網頁瀏覽(Chromium)和代理委派(群集)。主機程序提供排程任務(cron)、持久 SQLite 記憶和 WhatsApp 訊息傳遞。透過新增技能擴展功能。
支援。每個代理容器預裝 Chromium 和 agent-browser 用於瀏覽器自動化。Claude Code 可以在沙箱容器內搜尋網頁和瀏覽頁面以取得即時資訊。
官方且唯一可信的儲存庫是 github.com/qwibitai/nanoclaw。社群 Discord 是 discord.gg/VDdww8qS42。
macOS 和 Linux。需要 Node.js 20+ 和容器執行環境 — macOS 使用 Apple Container 或 macOS/Linux 使用 Docker。Windows 非官方支援,但可能透過 WSL2 搭配 Docker 運行。
NanoClaw 透過 Claude Agent SDK 完全使用 Anthropic Claude。在 .env 檔案中設定 ANTHROPIC_API_KEY,或透過 Claude Code OAuth 驗證。不支援多供應商 — SDK 內部處理模型選擇。
GitHub 儲存庫(github.com/qwibitai/nanoclaw)中的 README 是主要文件來源。docs/ 目錄包含架構規格、安全模型和除錯檢查清單。程式碼庫小巧到你可以讓 Claude Code 帶你走過。
官方頻道:Discord(discord.gg/VDdww8qS42)和 GitHub(github.com/qwibitai/nanoclaw)。查看 README 了解所有社群連結。