ZeroClaw龙虾AI助手介绍

ZeroClaw是由theonlyhennygod开发的一款基于Rust语言的全自主AI助手基础设施

核心优势

1. 轻量高效：发布版二进制文件仅3.4MB，启动时间<10ms，冷启动–help命令仅0.38s，内存占用极低，对比Node.js开发的OpenClaw，在体积、启动速度、内存占用上有数量级优势。
2. 安全设计：默认网关仅绑定本地地址，需6位一次性配对码获取令牌；文件系统默认作用于工作区，拦截敏感目录与空字节注入；支持隧道访问，拒绝无隧道的公网绑定；渠道消息需白名单授权，默认拒绝所有入站消息。
3. 高度可插拔：所有子系统基于Rust trait实现，仅需修改配置即可替换实现，无代码侵入，支持OpenAI兼容的自定义端点，避免技术锁定。
4. 功能完善：内置1017项测试，支持22+AI模型提供商、8大核心特质、50+跨9大分类的集成，拥有全栈自研内存系统，无外部依赖。

核心架构与子系统

所有子系统均为可扩展的trait，支持自定义实现，核心包含12大模块，关键模块能力如下：

1. AI模型（Provider）：支持OpenRouter、Anthropic、OpenAI、Ollama等22+提供商，兼容任意OpenAI格式的自定义API。
2. 通信渠道（Channel）：支持CLI、Telegram、Discord、Slack、WhatsApp等，所有渠道均支持白名单授权。
3. 内存系统（Memory）：自研SQLite全栈搜索引擎，融合向量余弦相似度（BLOB存储）与FTS5关键词搜索，支持混合加权查询，自动缓存嵌入向量，无Pinecone、Elasticsearch等外部依赖。
4. 安全策略（SecurityPolicy）：包含网关配对、沙箱、白名单、速率限制、文件系统作用域、加密密钥等多层防护。
5. 身份系统（IdentityConfig）：支持默认的OpenClaw（Markdown文件）与AIEOS v1.1（JSON）两种格式，AIEOS为AI身份标准化框架，支持跨系统导入导出，保障Agent行为一致性。

目前仅原生运行时（Mac/Linux/树莓派）正式支持，Docker、WASM为规划中功能，配置不支持的运行时会直接抛出清晰错误，而非静默降级。

快速使用

1. 安装：克隆仓库后通过cargo构建发布版，支持全局安装或开发模式前缀运行。
2. 初始化：提供三种onboard方式，包括无提示快速配置、交互式向导、仅渠道/白名单修复。
3. 核心操作：支持单条消息/交互式聊天、启动webhook网关（默认127.0.0.1:8080，可随机端口）、启动全自主守护进程、系统状态检查/诊断、渠道健康检测、背景服务管理，以及从OpenClaw迁移内存数据。
4. 典型命令：zeroclaw agent（聊天）、zeroclaw gateway（网关）、zeroclaw daemon（守护进程）、zeroclaw status（状态检查）。

关键配置

配置文件为~/.zeroclaw/config.toml，由onboard自动生成，核心可配置项包括：API密钥与默认AI提供商/模型、内存后端（SQLite/Markdown/无）与混合搜索权重、网关配对与公网绑定权限、自主运行级别（只读/监督/完全）、文件系统白名单/黑名单、隧道提供商、浏览器工具授权域名、身份格式等，所有敏感密钥默认加密存储。

网关API

提供5个核心接口，区分认证方式，适配不同场景：

1. /health：GET，无需认证，健康检查。
2. /pair：POST，X-Pairing-Code头认证，兑换配对码为Bearer令牌。
3. /webhook：POST，Bearer令牌认证，接收消息请求。
4. /whatsapp：GET，查询参数验证，Meta webhook验证；POST，Meta签名认证，接收WhatsApp入站消息。

特色功能

1. AIEOS身份支持：可通过文件或内联JSON配置AI身份，包含身份、心理、语言、动机、能力等8大维度，支持自定义MBTI、道德取向、行文风格等。
2. WhatsApp集成：适配Meta Business Cloud API，支持webhook推送模式，需配置HTTPS隧道（ngrok/Cloudflare/Tailscale）。
3. 浏览器自动化：可选browser_open工具，需显式配置授权域名，默认关闭。
4. Composio集成：可选开启，支持1000+OAuth应用，默认关闭。
5. 心跳任务：支持配置周期性任务，默认关闭。

项目地址

https://github.com/theonlyhennygod/zeroclaw