ZeroClaw 轻量级 AI Agent 运行时安装与使用指南

2. 核心命令

# 查看状态
zeroclaw status
# 交互式聊天
zeroclaw agent
# 单次提问
zeroclaw agent -m"帮我写一段 Rust 代码"
# 启动 Webhook 网关（默认 127.0.0.1:8080）
zeroclaw gateway
# 随机端口（更安全）
zeroclaw gateway --port 0
# 后台守护进程（长期运行）
zeroclaw daemon

3. 配置文件

配置默认路径：~/.config/zeroclaw/config.toml，可手动修改模型、通道、密钥等。

四、与 OpenClaw 对比

五、常见问题

• 安装失败：确保 Rust 版本 ≥ 1.70，执行 rustup update。
• 模型调用失败：检查 API Key 与 Provider 配置是否正确。
• 端口占用：用 zeroclaw gateway --port 0 随机端口。

六、Windows 自动化安装脚本

以下是完整的批处理脚本（.bat），包含 Rust 环境安装、ZeroClaw 编译、初始化配置全流程，你可以直接复制保存为 install_zeroclaw.bat。

@echo off
chcp 65001 > nul
echo ==============================================
echo ZeroClaw Windows 10 一键安装脚本
echo ==============================================
echo.
:: 检查管理员权限
>nul 2>&1 "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system"
if '%errorlevel%' NEQ '0' (
    echo 请以【管理员身份】运行此脚本！
    pause
    exit /b 1
)
:: 检查并安装 Rust 环境
echo [1/4] 检查 Rust 环境...
rustc --version > nul 2>&1
if errorlevel 1 (
    echo 未检测到 Rust，开始安装...
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o rustup-init.exe
    rustup-init.exe -y --default-toolchain stable --default-host x86_64-pc-windows-msvc
    :: 加载 Rust 环境变量
    call %USERPROFILE%\.cargo\env
    del rustup-init.exe
) else (
    echo Rust 已安装，正在更新到最新版本...
    rustup update stable
)
:: 克隆并编译 ZeroClaw
echo.
echo [2/4] 克隆并编译 ZeroClaw...
if not exist "zeroclaw" (
    git clone https://github.com/zeroclaw-labs/zeroclaw.git
) else (
    cd zeroclaw
    git pull
    cd ..
)
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked
cd ..
:: 初始化配置（交互式）
echo.
echo [3/4] 初始化 ZeroClaw 配置（请按提示输入 API Key）...
zeroclaw onboard --interactive
:: 验证安装
echo.
echo [4/4] 验证安装结果...
zeroclaw --version
if errorlevel 1 (
    echo 安装失败！
    pause
    exit /b 1
) else (
    echo ==============================================
    echo ZeroClaw 安装成功！
    echo 常用命令：
    echo 1. 交互式聊天：zeroclaw agent
    echo 2. 启动网关：zeroclaw gateway
    echo 3. 查看帮助：zeroclaw --help
    echo ==============================================
)
pause

1. 前置准备

• 确保你的 Windows 10 已安装：
  • Git（下载地址：https://git-scm.com/download/win）
  • curl（脚本会自动调用，若缺失可安装 Git 自带的 curl）
  • 网络通畅（需下载 Rust 和 ZeroClaw 源码）

2. 执行脚本

1. 新建文本文档，将上面的脚本复制进去，保存为 install_zeroclaw.bat（注意：保存类型选「所有文件」，编码选 UTF-8）。
2. 右键点击该批处理文件 → 以管理员身份运行（必须管理员权限，否则 Rust 安装失败）。
3. 脚本运行过程中：
   • 会自动安装/更新 Rust 环境（约 2-3 分钟，视网络而定）；
   • 编译 ZeroClaw（约 1-2 分钟）；
   • 最后进入交互式配置：按提示输入 AI 服务商（如 openrouter）、API Key 即可。

3. 快速使用 ZeroClaw

脚本安装完成后，打开「命令提示符（CMD）」或「PowerShell」，执行以下命令：

# 1. 交互式聊天（最常用）
zeroclaw agent
# 2. 单次提问（示例）
zeroclaw agent -m"用 Rust 写一个简单的 HTTP 服务器"
# 3. 启动 Web 网关（默认端口 8080）
zeroclaw gateway
# 4. 后台运行（需配合 Windows 任务计划程序）
zeroclaw daemon

4. 配置文件位置

Windows 10 下配置文件路径：C:\Users\你的用户名\.config\zeroclaw\config.toml，可手动修改 API Key、模型、端口等参数。

七、常见问题解决

1. 脚本提示'curl 不是内部命令'：
   • 安装 Git（自带 curl），并将 Git 的 bin 目录（如 C:\Program Files\Git\bin）添加到系统环境变量 PATH。
2. Rust 编译失败：
   • 确保 Rust 版本 ≥ 1.70，执行 rustup update 更新；
   • 安装 Visual Studio Build Tools（勾选「C++ 生成工具」）。
3. API 调用失败：
   • 检查 config.toml 中的 API Key 是否正确；
   • 确认服务商（如 OpenRouter）的密钥未过期、余额充足。

总结

1. 核心操作：将脚本保存为 .bat，以管理员身份运行，全程自动完成 Rust 安装、ZeroClaw 编译和配置；
2. 常用命令：zeroclaw agent（聊天）、zeroclaw gateway（启动网关）；
3. 关键注意：Windows 10 下必须用管理员权限运行脚本，否则 Rust 环境无法正常安装。