開始執行 ZeroClaw
單一 Rust 二進位，多種安裝方式。選適合你的就行。
checklist 系統需求
Rust toolchain (stable)，透過 rustup.rs 安裝——僅原始碼建置需要
Linux (x86_64, aarch64, armv7)、macOS (x86_64, aarch64)、Windows (x86_64)
執行時期：<5MB 記憶體。原始碼建置：2GB+ 記憶體，建議 4GB
二進位：約 8.8MB。原始碼建置：6GB 可用磁碟，建議 10GB
選用：Docker（沙箱執行時期）、Git（原始碼建置）
AI API 呼叫需要網路。透過 Ollama 使用本機模型可完全離線。
一行腳本搞定一切。推薦大多數用戶使用。
Remote One-Liner
macOS / Linux. Single command.
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash Local Bootstrap
Clone first, then bootstrap. More options.
git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw && ./bootstrap.sh # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter verified 驗證安裝
執行以下指令確認 ZeroClaw 已正確安裝。
zeroclaw --version 應輸出已安裝的版本號。執行耗時約 0.02s，峰值記憶體約 3.9MB。
zeroclaw doctor 執行系統診斷：Rust 版本、設定檔、Provider 連線狀態、頻道健康狀態。
zeroclaw onboard --interactive 互動式設定精靈，設定 API Key、選擇 Provider 和頻道。
settings 初始設定
安裝完成後，引導精靈會帶你完成設定。以下是每個步驟的說明。
選擇 AI Provider
從 Provider 目錄中選擇：OpenAI、Anthropic、Google Gemini、xAI、Mistral、DeepSeek、OpenRouter（100+ 模型），或任何 OpenAI 相容端點（包括 Ollama 本機模型）。
新增 API Key
貼上你的 API Key。Key 儲存在本機 config.toml 中——除了 AI Provider 不會傳送到任何地方。也支援訂閱驗證（OpenAI Codex、Anthropic），使用加密 Profile 儲存。
連接頻道
接入 Telegram（貼上 Bot Token）、Discord（貼上 Bot Token）、Slack（工作區應用程式）、WhatsApp（掃描 QR Code）或其他 17+ 支援的頻道。預設拒絕白名單策略。
啟動 Agent
執行 'zeroclaw agent -m "Hello!"' 快速測試，'zeroclaw daemon' 啟動完整自主執行時期，或 'zeroclaw service install' 安裝背景服務。
.env — 所有設定儲存在 ~/.zeroclaw/config.toml。直接編輯即可更改 Provider、頻道、記憶後端、通道和安全設定。完整參考見 docs/reference/README.md。
system_update_alt 升級 ZeroClaw
保持 ZeroClaw 最新版本，取得最新功能、整合和安全修補。
brew upgrade zeroclaw cargo install zeroclaw --force cd zeroclaw && git pull && cargo build --release --locked ./bootstrap.sh --docker --skip-build 在 github.com/zeroclaw-labs/zeroclaw/releases 查看每個版本的更新日誌。
build 疑難排解
常見問題及解決方法。