快速入门¶

本指南将帮助您在几分钟内开始使用 ZeroClaw。

安装¶

# 克隆仓库
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 构建并安装
cargo build --release --locked
cargo install --path . --force --locked

# 确保 ~/.cargo/bin 在您的 PATH 中
export PATH="$HOME/.cargo/bin:$PATH"

快速配置¶

ZeroClaw 提供三种配置方式：

1. 无提示快速设置¶

zeroclaw onboard --api-key sk-... --provider openrouter

2. 交互式向导¶

zeroclaw onboard --interactive

3. 仅修复频道/允许列表¶

zeroclaw onboard --channels-only

基本使用¶

聊天模式¶

# 单条消息模式
zeroclaw agent -m "Hello, ZeroClaw!"

# 交互模式
zeroclaw agent

启动网关服务器¶

# 默认端口 8080
zeroclaw gateway

# 随机端口（安全加固）
zeroclaw gateway --port 0

启动完整自主运行时¶

zeroclaw daemon

系统检查¶

# 查看状态
zeroclaw status

# 运行系统诊断
zeroclaw doctor

# 检查频道健康
zeroclaw channel doctor

# 获取集成设置详情
zeroclaw integrations info Telegram

后台服务管理¶

# 安装服务
zeroclaw service install

# 查看服务状态
zeroclaw service status

# 启动服务
zeroclaw service start

# 停止服务
zeroclaw service stop

# 卸载服务
zeroclaw service uninstall

从 OpenClaw 迁移¶

# 安全预览（不执行）
zeroclaw migrate openclaw --dry-run

# 执行迁移
zeroclaw migrate openclaw

配置文件¶

ZeroClaw 的配置文件位于 ~/.zeroclaw/config.toml，由 onboard 命令创建。

详细配置选项请参阅配置指南。

下一步¶

提示: 开发模式下可以直接使用 cargo run --release -- 前缀运行命令（例如：cargo run --release -- status）