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

五、常见问题

• 安装失败：确保 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. 执行脚本

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、模型、端口等参数。

三、常见问题解决

总结