ZeroClaw AI 智能体

ZeroClaw 是基于 Rust 的极致轻量 AI 智能体框架

系统要求

• 操作系统
  macOS、Linux、Windows (WSL2)

• 内存
  最低 512MB RAM

• 磁盘空间
  50MB 可用空间

• 网络:
  需要访问 AI Provider（OpenAI、Anthropic 等）

一键安装

官方安装脚本

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
"${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart

How would you like to install ZeroClaw?
[P] Pre-built binary  — fast, no Rust required  (default)
[s] Build from source — custom features, latest code
Choice [P/s]:P
Installing ZeroClaw v0.8.5 (pre-built)
✓ Platform: x86_64-unknown-linux-gnu
✓ Source:   https://github.com/zeroclaw-labs/zeroclaw/releases/download/v0.8.5/zeroclaw-x86_64-unknown-linux-gnu.tar.gz
✓ Channels: pre-built binaries ship the lean standard distribution set; availability is target-specific.
✓ Run 'zeroclaw channel list' to inspect this binary. For other channels such as Slack, build from source with --preset full.
################################## 100.0%
✓ Checksum verified
✓ Web dashboard installed to /home/mg/.local/share/zeroclaw/web/dist

✓ Installed: /home/mg/.cargo/bin/zeroclaw (v0.8.5, 59M)
✓ Installed: /home/mg/.cargo/bin/zerocode (36M)
✓ Added /home/mg/.cargo/bin to PATH in /home/mg/.bashrc
Reload your shell or run: source /home/mg/.bashrc
✓ Existing ZeroClaw config detected at /home/mg/.zeroclaw/config.toml — skipping setup prompt.
✓ Run 'zeroclaw quickstart' to reconfigure.
✓ Done. Run zerocode to launch the terminal UI and start working.

安装完成 运行 onboarding 向导

zeroclaw quickstart

配置 Gateway

onboarding 引导完成配置

1. 选择 Provider:
   OpenAI、Anthropic、OpenRouter、Ollama 等

2. 配置 API Key
   输入你的 AI 服务提供商密钥

3. 选择 Channel
   Telegram、Discord、Slack 等通讯渠道

4. 完成配对
   通过配对码连接你的设备

启动服务

Running as a service

Systemd is the default. OpenRC is detected and supported as a fallback.

zeroclaw service install     # 注册服务
zeroclaw service start       # 启动它
zeroclaw service stop        停止
zeroclaw service restart     # 停止 + 启动
zeroclaw service status      # 运行中 / 已停止，上次退出代码
zeroclaw service uninstall   # 删除它

卸载

如果你使用引导脚本进行安装，请使用同一脚本进行卸载：

./install.sh --uninstall

停止并移除服务：

zeroclaw service stop
zeroclaw service uninstall

移除二进制文件：

# cargo install / 引导
rm ~/.cargo/bin/zeroclaw

# Homebrew 如果是苹果系统
brew uninstall zeroclaw

删除配置和工作区（可选：此操作会删除对话历史记录）：

rm -rf ~/.zeroclaw ~/.config/zeroclaw

开始对话

配置完成后，向你配置的渠道（如 Telegram Bot）发送消息，即可开始与 AI 助手对话