轻量、快速、完全自治的 AI 助手基础设施,内存占用 <5MB,冷启动 <10ms,支持 20+ 消息通道与 15+ LLM 提供商,可部署至边缘设备。
ZeroClaw 是一款基于 Rust(95%)开发的 AI 助手运行时基础设施,采用 Trait-Driven 架构实现 Provider/Channel/Tool/Memory/Tunnel/Observer/Runtime/Identity/Heartbeat/Skills 等组件的全可插拔设计。
核心特性#
Lean Runtime:CLI/状态操作内存占用 <5MB,冷启动 <10ms(0.8GHz 低配核心),release 二进制约 8.8MB。
Secure-by-Design:Gateway 默认绑定 127.0.0.1(禁止 0.0.0.0),强制配对(6 位一次性码)换取 Bearer Token,文件系统隔离(workspace_only = true)、黑名单目录、符号链接逃逸检测、空字节注入阻断,Channel 白名单 deny-by-default。
可插拔 Provider:内置 OpenAI、Anthropic、OpenRouter、Google AI、Mistral、Groq、xAI、DeepSeek、Cohere、Perplexity、Ollama(本地/远程)、llama.cpp、vLLM、Osaurus;支持自定义 custom:https://your-api.com(OpenAI 兼容)或 anthropic-custom:https://your-api.com。
多渠道支持:CLI、Telegram、Discord、Slack、Mattermost、iMessage、Matrix、Signal、WhatsApp(Web/Business Cloud API)、Linq、Email、IRC、Lark、DingTalk、QQ、Nostr、Webhook 等 20+ 通道。
Memory 系统:SQLite hybrid search(向量 + FTS5 BM25)、PostgreSQL 后端、Lucid 桥接、Markdown 文件、none 后端;自研 Embedding + FTS5 + 混合合并,无外部向量数据库依赖。
内置 Tools:shell/file/memory、cron/schedule、git、pushover、browser、http_request、screenshot/image_info、composio(可选)、delegate、hardware 等。
Runtime 模式:native(本地直接执行)、docker(沙箱容器,Alpine 镜像、网络隔离、只读根文件系统、资源限制);WASM/边缘运行时计划中。
Skills 生态:TOML manifest + SKILL.md 指令;社区 open-skills 同步需显式启用;安装时静态安全审计。
适用场景#
- 边缘/嵌入式部署:10 美元级 SBC、树莓派、云小实例
- 本地优先 AI 助手:数据不出域、完全私有化
- 代码生成/重构/审查:结合 shell/git/file 工具
- 多渠道机器人/网关:统一 Agent 后端
- 定时任务/心跳调度:HEARTBEAT.md + cron 管理
- 数据敏感工作流:本地处理敏感数据
安装方式#
- Homebrew:
brew install zeroclaw - 一键脚本:
./bootstrap.sh(支持 --docker, --onboard, --prefer-prebuilt 等参数) - 预构建二进制:多架构 Linux/macOS/Windows
- 源码构建:
cargo build --release --locked
安全提示#
官方已声明存在假冒仓库/站点(如 openagen/zeroclaw、zeroclaw.org/.net),仅 github.com/zeroclaw-labs/zeroclaw 为官方来源。