开始运行 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（扫码）或其他 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 常见问题排查
常见问题及解决方法。