ZEROCLAW · 项目总览
zeroclaw
用 Rust 构建的下一代 AI Agent 框架。3.4MB 单二进制文件，不到 10ms 启动，内存占用低于 5MB。 支持 20+ LLM 提供商、50+ 内置工具、WASM 插件扩展，以及 OS 级别沙箱安全隔离。 覆盖从交互式 Chat、HTTP 网关到完全自治后台 Daemon 的全部运行模式。
3.4MB
单二进制大小
31.5K
GitHub Stars
50+
内置工具数量
<10ms
冷启动时间
为什么选择 zeroclaw？
大多数 AI Agent 框架依赖臃肿的 Python 运行时，启动需要数秒，内存动辄数百 MB。 zeroclaw 使用 Rust 重新设计整个执行栈——单文件部署、毫秒级启动、极低资源占用， 同时提供企业级安全沙箱（Landlock / Bubblewrap / Seatbelt）与完整的 WASM 插件生态。 它既可作为个人开发者的命令行 AI 助手，也可作为生产环境中的多租户 Agent 网关。
📚 文档导航
第一章
搭建 · 部署 · 使用
安装方法（Cargo / 二进制 / Homebrew / 源码）、API Key 配置、三种运行模式、Docker 部署、WASM 插件管理。
→
第二章
架构 · 模块 · 文件结构
五层架构设计、10 大核心模块详解、安全子系统、支持的 LLM 提供商、Rust 文件树与命名规范。
→
第三章
运行时 · 状态机 · 流程
三种进程模型对比、Chat 模式完整状态机、Gateway 路由链路、SOP 执行流程、WASM 调用链、tokio 并发模型。
→
🏗️ 五层架构一览
zeroclaw 将整个 Agent 系统分为五个垂直层次，每层职责清晰、可独立替换。
Layer 1
输入层
CLI TUI · HTTP API · WebSocket · Voice · iOS · Browser Extension · 30+ 渠道
Layer 2
核心 Agent 层
Agent Loop · SOP 引擎 · Task Scheduler · 对话上下文管理
Layer 3
执行层
20+ LLM 提供商 · Tool Registry (50+ 工具) · WASM Plugin Runtime
Layer 4
基础设施层
Config Manager · 硬件检测 · Plugin System · Safety Engine
Layer 5
存储层
SQLite (会话持久化) · Vector DB (向量嵌入) · 文件系统
⚡ 核心特性
Rust 原生性能
零垃圾回收、零运行时依赖。3.4MB 单二进制文件可在任何平台直接运行，冷启动时间低于 10ms，内存占用低于 5MB。
OS 级别安全沙箱
Linux 使用 Landlock + Bubblewrap，macOS 使用 Seatbelt。每个工具调用均在受限沙箱中执行，文件系统路径、网络访问、进程创建均可精细配置。
WASM 插件扩展
通过 Wasmtime 运行 WebAssembly 插件，插件调用走 JSON-RPC 2.0 协议，沙箱隔离，支持热加载，社区插件生态持续扩张。
多模式部署
Chat 模式适合个人使用，Gateway 模式提供 HTTP/WebSocket API 供应用集成，Daemon 模式支持全自治后台 Agent，三种模式均由同一二进制文件提供。
🤖 支持的 LLM 提供商
zeroclaw 通过统一的 provider_router 抽象层支持 20+ 主流 LLM 提供商，可在配置文件或命令行中自由切换。
Anthropic Claude
OpenAI GPT
Google Gemini
AWS Bedrock
Google Vertex AI
Mistral
Cohere
Together AI
Fireworks AI
Groq
DeepSeek
Ollama (本地)
LM Studio (本地)
vLLM (本地)
llama.cpp (本地)
+ 更多
🚀 快速上手
三步启动 zeroclaw：
# 1. 安装 (推荐 cargo) cargo install zeroclaw # 2. 设置 API Key export ANTHROPIC_API_KEY=sk-ant-... # 3. 启动交互式 Chat zeroclaw
📋 项目基本信息
| 属性 | 值 |
|---|---|
| GitHub 仓库 | zeroclaw-labs/zeroclaw |
| 主要语言 | Rust |
| 异步运行时 | tokio |
| WebAssembly 引擎 | Wasmtime |
| 数据库 | SQLite + Vector DB |
| 协议 | HTTP / WebSocket / JSON-RPC 2.0 |
| 二进制大小 | 3.4 MB (release build) |
| 内存占用 | < 5 MB (idle) |
| 启动时间 | < 10 ms |
| GitHub Stars | 31,500+ |
| 支持平台 | Linux · macOS · Windows |
| 默认 LLM 模型 | claude-sonnet-4-5 |
| 许可证 | MIT |