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

# 查看状态
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 10 一键安装脚本示例

以下批处理脚本包含 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
    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. 确保已安装 Git（需包含 curl）。
2. 将脚本保存为 .bat 文件，编码选 UTF-8。
3. 右键点击该批处理文件 → 以管理员身份运行。
4. 按提示输入 AI 服务商及 API Key。

配置文件位置

Windows 下配置文件路径：C:\Users\你的用户名\.config\zeroclaw\config.toml。