🦀 100% Rust · MIT OR Apache 2.0
ZeroClaw
Fast, small, fully autonomous AI personal assistant infrastructure.
Deploy anywhere. Swap anything. You own the agent.
3.4MB
Binary Size
<5MB
RAM Usage
<10ms
Startup Time
31.5k
GitHub Stars
项目定位
核心理念
- 本地优先（Local-First）：数据不离开用户机器
- 模块化 Trait 架构：每个子系统可独立替换
- 单一静态二进制，零外部运行时依赖
- ARM / x86 / RISC-V 全平台支持
- 100% Rust，Edition 2024，无 GC
能力矩阵
- 30+ 通道适配器（Discord、Telegram、Matrix、Email、CLI…）
- 20+ LLM Provider（Anthropic、OpenAI、Ollama、DeepSeek…）
- 内置向量内存引擎（无外部向量数据库）
- SOP 引擎 + Cron 调度 + Webhook Gateway
- GPIO / I2C / SPI / USB 硬件支持
- WASM 插件系统
- IDE 集成（ACP JSON-RPC 2.0）
技术栈
Rust Edition 2024
Tokio (async)
Clap (CLI)
Mermaid (diagrams)
TOML config
SQLite (memory)
WebSocket
JSON-RPC 2.0
WASM plugins
Docker / K8s
Nix flake
Justfile
安全模型
沙箱层级
- Workspace 目录边界（文件访问限制）
- 命令 Allowlist（git, npm, cargo 等）
- OS 级沙箱：Landlock / Bubblewrap / Seatbelt
- Docker 容器隔离
- API 密钥本地加密存储
风险分级
- 低风险：自动执行
- 中风险：需要人工审批（approval_manager）
- 高风险：直接阻断
- Tool Receipts：加密工具调用凭证
- Verifiable Intent：意图可验证链路
运行模式速览
Chat Mode
单次交互，命令行即时对话。适合快速查询。
zeroclaw agent -a <alias>
Gateway Mode
HTTP/WebSocket webhook 服务器（默认端口 8080）。适合 API 集成。
zeroclaw gateway start
Daemon Mode
全自主运行时：多通道 + 调度器 + SOP 引擎。生产首选。
zeroclaw daemon start