ZeroClaw：Rust编写、轻量级、自主运行的OpenClaw

核心定位
ZeroClaw 的定位可以这样理解：

• 完全自主的 AI 助手基础设施：支持 AI 任务的管理、执行和扩展，而无需外部框架或依赖。
• 与 OpenClaw 等项目类似，但强调 更快、更小、更安全 的 Rust 实现。
• 适合部署在各种环境（本地、服务器、容器等），用途包括聊天代理、自动化任务、集成消息渠道等。

特性亮点
Rust 原生实现

• 100% 用 Rust 写成 — 二进制非常小（约 3.4 MB）且启动极快（< 10 ms）。
• 内存占用低，性能优势明显。

• 用 traits 定义核心组件（比如提供者、渠道、工具、内存）→ 可以轻松替换实现，例如接入不同的 AI 平台或消息渠道而无需改代码。

• 默认支持 22+ AI 提供者（OpenRouter、OpenAI、Anthropic、Mistral 等），可以配置任意 OpenAI-兼容 API。

• 支持 CLI、Telegram、Discord、Slack、Webhook 等多种交互方式。

• 内置自定义的向量搜索 + 关键词搜索作为记忆后端（基于 SQLite），无需额外依赖。

• 默认安全设计包括 pairing、严格沙箱、白名单、文件系统范围限制等

典型用途场景

✅ 快速搭建AI助手/代理
✅ 集成多平台消息渠道
✅ 在资源受限环境运行智能体（如物理服务器、嵌入式设备等）
✅ 构建安全边界明确的自动化 AI 服务

️ 如何上手

基本启动流程（Rust + Cargo）如下：

git clone https://github.com/theonlyhennygod/zeroclaw.git
cd zeroclaw
cargo build --release
cargo install --path . --force
zeroclaw onboard --api-key sk-... --provider openrouter
zeroclaw agent -m "Hello, ZeroClaw!"

详细使用说明和命令可以在仓库的 README 中找到。

总结

ZeroClaw 是一个面向开发者和团队的 Rust 原生 AI 代理基础设施，它强调：

✔ 安全
✔ 高性能
✔ 模块可插拔
✔ 多平台支持

如果你想自己部署一个高效、安全、灵活的 AI 助手运行时，ZeroClaw 是一个值得探索的开源选择。

为什么团队选择ZeroClaw

• 默认情况下是精益的：小的Rust二进制文件，快速启动，低内存占用。
• 安全设计：配对，严格的沙箱，明确的允许列表，工作空间范围。
• 完全可交换：核心系统是特质（提供者，通道，工具，内存，隧道）。
• 无锁定：OpenAI兼容的提供程序支持+可插拔的自定义端点。

内存系统

这套内存系统就像一个超级搜索引擎，但完全是自己动手造的，没借用任何外部工具（比如Pinecone、Elasticsearch、LangChain这些）：

底层结构：
- 向量数据库：用SQLite存数据，把内容转换成“特征码”（嵌入）存成二进制文件，搜索时用余弦相似度找相近的内容
- 关键词搜索：用SQLite的全文搜索功能，配合BM25算法给结果打分
- 混合搜索：自己写了个加权合并函数，把上面两种搜索结果按权重混在一起

核心功能：
- 生成特征码：支持多种方式——可以用OpenAI的接口，也可以用自定义的URL，或者干脆不生成
- 内容分块：专门针对Markdown文件，按行切块，还能保留标题结构
- 缓存机制：建了个SQLite缓存表存特征码，空间不够时自动淘汰最久没用的
- 安全重建：能重新建立全文搜索索引，同时只重新生成缺失的特征码，不会重复干活

身份系统

这套身份系统是让AI拥有“人格”的，支持两种格式：

第一种：OpenClaw（默认方式）
在工作目录里放几个Markdown文件：
- IDENTITY.md - 这个AI是谁（比如名字、身份）
- SOUL.md - 它的核心性格和价值观
- USER.md - 它服务的对象是谁
- AGENTS.md - 它要遵守的行为规则

第二种：AIEOS（AI实体对象规范）
这是一种标准化的AI身份格式。ZeroClaw支持AIEOS v1.1版本的JSON数据，好处是：
- 可以从其他支持AIEOS的系统里导入AI身份
- 也可以把自己的AI身份导出给别人用
- 在不同AI模型之间切换时，性格和行为能保持一致
- 让AI的身份信息变得更通用、更规范