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 |shsource$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. 执行脚本
- 新建文本文档，将上面的脚本复制进去，保存为
install_zeroclaw.bat（注意：保存类型选「所有文件」，编码选 UTF-8）。 - 右键点击该批处理文件 → 以管理员身份运行（必须管理员权限，否则 Rust 安装失败）。
- 脚本运行过程中：
- 会自动安装/更新 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、模型、端口等参数。
三、常见问题解决
- 脚本提示“curl 不是内部命令”：
- 安装 Git（自带 curl），并将 Git 的
bin目录（如C:\Program Files\Git\bin）添加到系统环境变量PATH。
- 安装 Git（自带 curl），并将 Git 的
- Rust 编译失败：
- 确保 Rust 版本 ≥ 1.70，执行
rustup update更新； - 安装 Visual Studio Build Tools（勾选「C++ 生成工具」）。
- 确保 Rust 版本 ≥ 1.70，执行
- API 调用失败：
- 检查
config.toml中的 API Key 是否正确； - 确认服务商（如 OpenRouter）的密钥未过期、余额充足。
- 检查
总结
- 核心操作：将脚本保存为
.bat，以管理员身份运行，全程自动完成 Rust 安装、ZeroClaw 编译和配置； - 常用命令：
zeroclaw agent（聊天）、zeroclaw gateway（启动网关）； - 关键注意：Windows 10 下必须用管理员权限运行脚本，否则 Rust 环境无法正常安装。
