ZeroClaw 保姆级安装与配置教程

ZeroClaw 是目前 AI Agent 领域最硬核、最轻量级的开源项目之一。它是 OpenClaw 的 Rust 重写版，内存占用仅为约 5MB（比 OpenClaw 节省 99%），甚至可以在 10 美元的树莓派或廉价 VPS 上运行。

本教程将手把手带你完成从环境准备到接入 Telegram 的全流程。

目录

• 环境准备
• 获取并编译
• 快速配置
• 连接 Telegram
• 常用命令与技巧
• 安全注意事项
• 故障排除

🛠️ 第一步：环境准备（以 Linux/Ubuntu 为例）

ZeroClaw 几乎不依赖外部环境，但编译需要 Rust 工具链。

1. 更新系统软件包

sudo apt update && sudo apt upgrade -y

2. 安装必要依赖

sudo apt install -y build-essential curl git pkg-config libssl-dev

• build-essential：GCC、make 等编译工具
• curl：下载 Rust 安装脚本
• git：克隆 ZeroClaw 仓库
• pkg-config、libssl-dev：链接与 SSL 相关依赖

3. 安装 Rust（官方推荐方式）

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

• 出现选项时按 1（默认安装）即可
• 安装完成后加载环境变量：

source "$HOME/.cargo/env"

验证安装：

rustc --version
cargo --version

📥 第二步：获取并编译 ZeroClaw

1. 克隆仓库

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

2. 编译项目（Release 模式）

cargo build --release

首次编译会下载依赖并编译，可能需要 3～10 分钟，视机器性能而定。完成后可执行文件位于 target/release/zeroclaw。

3. 全局安装（可选）

若希望在任何目录都能直接使用 zeroclaw 命令：

cargo install --path .

安装后可直接在终端输入 zeroclaw --help 验证。

⚙️ 第三步：快速配置（Onboarding）

ZeroClaw 提供配置向导，无需手改 .toml 文件。

准备 API Key

需要至少一个 LLM API Key。若还没有，推荐到 OpenRouter 注册，它聚合了多数主流模型（如 GPT-4、Claude、Gemini、DeepSeek 等），一个 Key 即可切换模型。

方式一：快速绑定（推荐）

一条命令完成 API 与默认配置：

zeroclaw onboard --quick --api-key "你的API_KEY" --provider openrouter

将 你的API_KEY 替换为你在 OpenRouter（或其他支持的 provider）获取的 Key。

方式二：交互式全配置

如需自定义模型、基础 URL、超时等：

zeroclaw onboard --interactive

按提示选择 provider、填写 API Key、模型 ID 等即可。

🤖 第四步：连接对话频道（以 Telegram 为例）

配置好 API 后，可让 Agent 在 Telegram 中与你对话。

1. 获取 Telegram Bot Token

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot
3. 按提示设置 Bot 名称和用户名
4. 复制返回的 API Token（形如 123456789:ABCdefGHI...）

2. 在 ZeroClaw 中开启 Telegram 频道

zeroclaw onboard --channels-only

• 选择 Telegram
• 粘贴刚才复制的 Token
• 在 Allowed Identities（允许使用的账号）中：
• 输入 * 表示任何人可用（仅建议在测试或私用 Bot 时使用）
• 或填写你的 Telegram 用户 ID（可通过 @userinfobot 获取）以限制仅自己可用

3. 启动 Agent 服务

zeroclaw agent

保持该进程运行，然后在 Telegram 中打开你的 Bot，发送消息即可与 ZeroClaw Agent 对话。

💡 进阶：常用命令与技巧

使用技巧

• 仅终端对话：不配置 Telegram 等频道时，直接 zeroclaw agent 即可在终端与 Agent 交互。
• 后台运行：在 VPS 上可配合 systemd、screen 或 tmux 让 zeroclaw agent 常驻后台。
• 多模型切换：若使用 OpenRouter，可在配置中更换模型 ID（如 openai/gpt-4o、anthropic/claude-3-5-sonnet 等）。

⚠️ 安全警告（必读）

1. 隔离运行
   ZeroClaw 具备 Shell 执行能力。强烈建议在 VPS（云服务器） 或 Docker 容器 中运行，不要在生产环境外的个人主力机上长期开放。若在本地 Mac/PC 上试用，请务必在配置中限制权限（默认为 Supervised 模式，需确认理解其含义后再放宽）。

2. API 额度
   因占用极低，容易长时间挂着 Agent，请留意所用 API 的用量与账单，避免超额。

3. Token 与配置安全
   不要将 API Key、Bot Token 提交到公开仓库或截图外泄。配置文件通常位于用户目录下，注意文件权限与备份方式。

🔧 故障排除

运行 zeroclaw doctor 可自动检查环境与配置，便于定位问题。

完成以上步骤后，你就拥有了一台可从终端或 Telegram 调用的轻量级 AI Agent。若需针对特定国产大模型（如 DeepSeek、豆包等）编写自定义配置示例，可基于 zeroclaw onboard --interactive 生成的配置进行修改，或查阅官方文档中的 provider 与模型配置说明。