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 运行

Windows：下载 rustup-init.exe

编译安装

git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw cargo build --release--lockedcargoinstall--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 --port0# 后台守护进程（长期运行） zeroclaw daemon 

3. 配置文件

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

四、与 OpenClaw 对比

五、常见问题

• 安装失败：确保 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 环境无法正常安装。