ZeroClaw 是一款纯 Rust 编写、超轻量、高性能的 AI Agent 运行时,主打极低资源占用、快速启动与多模型/多通道接入,适合本地/嵌入式/服务器部署。
一、ZeroClaw 核心介绍
ZeroClaw 定位为轻量级 AI 助手基础设施,核心优势:
- 极致轻量:编译后仅约 3.4MB 单文件二进制,运行内存 < 5MB,启动 < 10ms。
- 纯 Rust 实现:无 Node.js 依赖,安全、稳定、内存安全。
ZeroClaw 是一个基于 Rust 开发的轻量级 AI Agent 运行时,具备极低资源占用和多模型兼容特性。支持源码编译、包管理器及 Docker 等多种安装方式,提供 CLI、Telegram 等多通道接入。内置 SQLite 存储,支持插件化扩展。文章详细介绍了其核心功能、安装步骤、常用命令、与 OpenClaw 的性能对比,并提供了 Windows 系统的一键安装脚本及常见问题解决方案。
ZeroClaw 是一款纯 Rust 编写、超轻量、高性能的 AI Agent 运行时,主打极低资源占用、快速启动与多模型/多通道接入,适合本地/嵌入式/服务器部署。
ZeroClaw 定位为轻量级 AI 助手基础设施,核心优势:
前置:安装 Rust 环境
# 安装 Rust(Linux/macOS)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
编译安装
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked
# Homebrew(macOS)
brew install zeroclaw
# 其他发行版可从 GitHub Release 下载预编译二进制
docker pull zeroclaw/zeroclaw
docker run -it --rm zeroclaw/zeroclaw --help
# 交互式配置向导
zeroclaw onboard --interactive
# 一键配置(OpenRouter 示例)
zeroclaw onboard --api-key sk-xxxxxx --provider openrouter
# 查看状态
zeroclaw status
# 交互式聊天
zeroclaw agent
# 单次提问
zeroclaw agent -m"帮我写一段 Rust 代码"
# 启动 Webhook 网关(默认 127.0.0.1:8080)
zeroclaw gateway
# 随机端口(更安全)
zeroclaw gateway --port 0
# 后台守护进程(长期运行)
zeroclaw daemon
配置默认路径:~/.config/zeroclaw/config.toml,可手动修改模型、通道、密钥等。
| 特性 | ZeroClaw | OpenClaw |
|---|---|---|
| 语言 | 100% Rust | Node.js + TypeScript |
| 体积 | ~3.4MB | ~28MB + 依赖(>400MB) |
| 内存 | <5MB | ~390MB |
| 启动 | <10ms | 秒级 |
| 依赖 | 无 | Node.js 运行时 |
| 部署 | 本地/嵌入式/服务器 | 本地/服务器 |
rustup update。zeroclaw gateway --port 0 随机端口。以下是完整的批处理脚本(.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
install_zeroclaw.bat(注意:保存类型选「所有文件」,编码选 UTF-8)。脚本安装完成后,打开「命令提示符(CMD)」或「PowerShell」,执行以下命令:
# 1. 交互式聊天(最常用)
zeroclaw agent
# 2. 单次提问(示例)
zeroclaw agent -m"用 Rust 写一个简单的 HTTP 服务器"
# 3. 启动 Web 网关(默认端口 8080)
zeroclaw gateway
# 4. 后台运行(需配合 Windows 任务计划程序)
zeroclaw daemon
Windows 10 下配置文件路径:C:\Users\你的用户名\.config\zeroclaw\config.toml,可手动修改 API Key、模型、端口等参数。
bin 目录(如 C:\Program Files\Git\bin)添加到系统环境变量 PATH。rustup update 更新;config.toml 中的 API Key 是否正确;.bat,以管理员身份运行,全程自动完成 Rust 安装、ZeroClaw 编译和配置;zeroclaw agent(聊天)、zeroclaw gateway(启动网关);
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online