常見問題
關於 ZeroClaw 的常見問題和解答。
ZeroClaw 是一個用 Rust 撰寫的超輕量、完全自主的 AI Agent 執行時期。它是基礎設施層,抽象了模型、工具、記憶和執行,讓 Agent 一次建置、到處執行——從 10 美元的 ARM 開發板到雲端伺服器。
macOS:'brew install zeroclaw'。Linux:執行一鍵引導腳本 'curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash'。Windows:先透過 rustup 安裝 Rust,然後 'cargo install zeroclaw'。所有平台也提供預編譯二進位套件。
ZeroClaw 記憶體佔用 <5MB,OpenClaw 要 >1GB。同等硬體上啟動時間 <10ms vs >500s。二進位約 8.8MB、零執行時期相依性,而 OpenClaw 需要 Node.js(約 390MB 額外開銷)。ZeroClaw 能在 10 美元的硬體上跑,OpenClaw 通常需要 599 美元的 Mac mini。
ZeroClaw 透過 Provider trait 實現完全模型無關。內建支援 OpenAI、Anthropic、Google Gemini、xAI Grok、Mistral、DeepSeek、Perplexity、Hugging Face、OpenRouter(100+ 模型),以及任何 OpenAI 相容端點(包括透過 Ollama 使用本機模型)。
ZeroClaw 支援 17+ 頻道:CLI、Telegram、Discord、Slack、WhatsApp、Signal、iMessage、Matrix、Mattermost、IRC、Lark、DingTalk、QQ、Nostr、Email、Linq 和 Webhook。所有頻道使用預設拒絕的白名單策略保障安全。
安全在每一層都有保障:閘道僅綁定 localhost,6 位配對碼驗證,檔案系統作用域 + 系統目錄封鎖,符號連結逃逸偵測,預設拒絕的頻道白名單,以及可選的 Docker 沙箱執行時期。通過了社群安全檢查清單的所有項目。
ZeroClaw 內建了一個零外部相依性的全端搜尋引擎。包括 SQLite 向量資料庫 + 餘弦相似度、FTS5 關鍵字搜尋 + BM25 評分、自訂混合合併、可插拔的 Embedding Provider 和 LRU 快取淘汰。後端支援:SQLite、PostgreSQL、Lucid、Markdown 或不使用。
完全可以。ZeroClaw 就是為低成本硬體設計的。<5MB 的記憶體佔用和單一靜態二進位意味著它能在樹莓派、Orange Pi 和其他 ARM 單板電腦上輕鬆執行。在資源受限的裝置上引導安裝時用 '--prefer-prebuilt' 跳過編譯。
ZeroClaw 的每個子系統(Provider、Channel、Tool、Memory、Tunnel、Runtime、Security、Identity、Observability)都定義為 Rust trait。你可以透過設定替換任何實作——不需要改程式碼。例如從 SQLite 切換到 PostgreSQL 記憶後端,或從 Cloudflare 切換到 ngrok 通道。
專案在 github.com/zeroclaw-labs/zeroclaw 開源,採用 Apache 2.0 授權條款。貢獻指南見 docs/contributing/README.md。由 Harvard、MIT 和 Sundai.Club 社群的學生和成員打造。歡迎所有貢獻。
內建工具包括 Shell/檔案/記憶操作、排程/計畫任務、Git 整合、瀏覽器自動化、HTTP 請求、截圖/圖片工具、Pushover 通知、Composio(可選)、任務委派和硬體工具。你還可以透過 TOML 清單使用社群 Skill 套件擴充。
支援。ZeroClaw 支援 Cloudflare、Tailscale、ngrok 和自訂通道二進位。為了安全,沒有活躍通道時閘道拒絕公網綁定。透過設定中的 Tunnel trait 進行設定。
官方且唯一可信的儲存庫是 github.com/zeroclaw-labs/zeroclaw。官方網站是 zeroclawlabs.ai。不要信任 zeroclaw.org 或 zeroclaw.net——那些是另一個 fork 的冒充。
預編譯二進位套件支援 Linux (x86_64, aarch64, armv7)、macOS (x86_64, aarch64) 和 Windows (x86_64)。Rust 的可攜式架構還支援 ARM、x86 和 RISC-V。
執行 'zeroclaw onboard --api-key sk-... --provider openrouter' 快速設定,或 'zeroclaw onboard --interactive' 使用精靈。ZeroClaw 也支援 OpenAI Codex 和 Anthropic Claude Code 的訂閱驗證,使用加密 Profile 儲存。
完整文件在儲存庫的 docs/README.md,目錄在 docs/SUMMARY.md。快速入口:docs/reference 查 API 參考,docs/operations 查維運指南,docs/troubleshooting 查常見問題,docs/security 查安全細節。
官方頻道:X (@zeroclawlabs)、Reddit (r/zeroclawlabs)、Telegram (@zeroclawlabs,中文 @zeroclawlabs_cn,俄語 @zeroclawlabs_ru)、微信群和小紅書。全部列在 GitHub README 中。