AI agent：介绍 ZeroClaw 安装，使用

ZeroClaw 是一款纯 Rust 编写、超轻量、高性能的 AI Agent 运行时，主打极低资源占用、快速启动与多模型/多通道接入，适合本地/嵌入式/服务器部署。

---

一、ZeroClaw 核心介绍

ZeroClaw 定位为轻量级 AI 助手基础设施，核心优势：

• 极致轻量 ：编译后仅约 3.4MB 单文件二进制，运行内存 < 5MB ，启动 < 10ms。
• 纯 Rust 实现：无 Node.js 依赖，安全、稳定、内存安全。
• 多模型兼容 ：原生支持 22+ AI 服务商（OpenAI、Anthropic、Mistral、OpenRouter、Ollama 等），兼容 OpenAI API 格式。
• 多通道接入：CLI、Telegram、Discord、Slack、Webhook 等。
• 插件化架构：模型、通道、记忆、工具均为可插拔模块，易扩展。
• 本地优先：默认 SQLite 存储，支持全文检索与向量搜索。

---

二、安装（3 种方式）

1. 源码编译（推荐，全平台通用）

前置：安装 Rust 环境

# 安装 Rust（Linux/macOS）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Windows：下载 rustup-init.exe 运行

编译安装

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked

2. 包管理器（macOS/Linux）

# Homebrew（macOS）
brew install zeroclaw

# 其他发行版可从 GitHub Release 下载预编译二进制

3. Docker（快速部署）

docker pull zeroclaw/zeroclaw
docker run -it --rm zeroclaw/zeroclaw --help

---

三、快速使用

1. 初始化配置（onboard）

# 交互式配置向导
zeroclaw onboard --interactive

# 一键配置（OpenRouter 示例）
zeroclaw onboard --api-key sk-xxxxxx --provider openrouter

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 对比

特性	ZeroClaw	OpenClaw
语言	100% Rust	Node.js + TypeScript
体积	~3.4MB	~28MB + 依赖（>400MB）
内存	<5MB	~390MB
启动	<10ms	秒级
依赖	无	Node.js 运行时
部署	本地/嵌入式/服务器	本地/服务器

---

五、常见问题

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

---

需要我帮你生成一份可直接复制的一键安装+配置+启动脚本，并适配你的系统（Linux/macOS/Windows）吗？是的。

你需要一份适配 Windows 10 系统的 ZeroClaw 一键安装、配置、启动脚本，我会为你提供完整的可执行脚本和详细的操作步骤，确保你能快速上手。

一、一键安装&配置脚本（Windows 10 专用）

以下是完整的批处理脚本（.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

二、使用步骤（Windows 10 操作指南）

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 环境无法正常安装。