ZeroClaw：零开销全 Rust AI 助手基础设施及与 OpenClaw 对比

主要功能

核心作用

ZeroClaw 的核心作用是提供与 OpenClaw 同类的「多模型 + 多渠道 + 记忆 + 工具」能力，在资源与性能上做减法、在可插拔与安全上做加法：

1. 多 Provider：内置多种 AI 提供商（约 28+ 及别名），支持 OpenAI 兼容与 Anthropic 自定义端点
2. 多 Channel：CLI、Telegram、Discord、Slack、Mattermost、iMessage、Matrix、Signal、WhatsApp、Email、IRC、Lark、DingTalk、QQ、Webhook 等
3. 记忆系统：SQLite 混合检索（向量 + FTS5）、Lucid 桥接、Markdown 文件、或显式关闭（none）；支持从 OpenClaw 迁移（migrate openclaw）
4. 工具与运行时：shell/file/memory、cron、git、pushover、browser、http_request、screenshot、composio 等；运行时支持 native 或 Docker 沙箱
5. 安全：Gateway 配对码、沙箱、白名单、速率限制、工作区文件系统范围、加密密钥存储
6. 身份：默认 OpenClaw 格式（Markdown）；可选 AIEOS v1.1（JSON）便于跨系统移植人设
7. 订阅认证：OpenAI Codex（ChatGPT 订阅）、Claude Code / Anthropic setup-token 等多账号、加密存储

使用场景

1. 从 OpenClaw 平滑迁移：继续使用现有 SOUL/IDENTITY 与记忆，用 zeroclaw migrate openclaw 导入，在更小资源下运行
2. 边缘与低成本部署：树莓派、10 美元级板子、小内存 VPS；单二进制、无 Node，冷启动与内存占用显著低于 OpenClaw
3. 脚本与自动化：CLI 冷启动极快，适合 cron、CI 或脚本中频繁调用 zeroclaw agent / zeroclaw status
4. 安全与合规优先：默认本地绑定、配对、工作区限定、Docker 沙箱、白名单，满足「不暴露公网、最小权限」需求
5. 多身份与订阅：多 Profile（OpenAI Codex、Anthropic）、加密存储，适合多账号或团队统一网关

快速开始

环境：Rust 工具链（或使用仓库内一键安装脚本安装系统依赖 + Rust + ZeroClaw）。

一键安装（推荐先审阅脚本）：

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash

从源码构建并安装：

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked
export PATH="$HOME/.cargo/bin:$PATH"

快速配置与对话：

# 无交互快速配置（API Key + Provider）
zeroclaw onboard --api-key sk-... --provider openrouter
# 或交互向导
zeroclaw onboard --interactive
# 单条消息
zeroclaw agent -m "Hello, ZeroClaw!"
# 交互对话
zeroclaw agent
# 启动 Gateway（默认 127.0.0.1:3000）
zeroclaw gateway
# 后台常驻（含渠道与定时任务）
zeroclaw daemon

从 OpenClaw 迁移记忆：

zeroclaw migrate openclaw --dry-run # 预览
zeroclaw migrate openclaw # 执行迁移

核心特性

1. 单二进制、极低内存：Release 构建下，zeroclaw --help / zeroclaw status 约 3.9–4.1MB 峰值内存；README 称常见场景 <5MB，约为 OpenClaw（>1GB，含 Node）的约 1%
2. 毫秒级冷启动：同文档示例：0.01–0.02s 级 real time；README 表内在 0.8GHz 边缘设备上 <10ms，对比 OpenClaw >500s（冷启动）
3. Trait 驱动、全可插拔：Provider、Channel、Memory、Tool、Runtime、Tunnel、Identity 等均为 Trait，可换实现或扩展，配置驱动、无需改核心代码
4. 安全默认：Gateway 默认 127.0.0.1、配对码、工作区限定、禁止敏感路径、可选 Docker 沙箱；README 提供安全清单与自测建议（如 nmap）
5. OpenClaw 兼容与迁移：身份格式默认与 OpenClaw Markdown 一致；migrate openclaw 支持把 OpenClaw 记忆迁入 ZeroClaw
6. 订阅与多账号：OpenAI Codex OAuth、Anthropic setup-token、多 Profile、加密存储（auth-profiles.json + .secret_key）

ZeroClaw 与 OpenClaw：关系与对比

二者关系简述

• 产品形态一致：都是「自托管 AI 助手网关」——多模型、多渠道、持久记忆、技能/工具、可选自主运行（daemon）。
• 实现不同：OpenClaw 为 TypeScript/Node.js 生态；ZeroClaw 为 Rust，单静态二进制，无 Node 依赖。
• 兼容与迁移：ZeroClaw 默认支持 OpenClaw 式身份（IDENTITY.md、SOUL.md 等），并提供 zeroclaw migrate openclaw 做记忆迁移，方便从 OpenClaw 迁到 ZeroClaw 而不丢失人设与历史。
• 定位差异：OpenClaw 生态成熟、Skill 与第三方集成多；ZeroClaw 主打资源与性能（小内存、快启动、低成本硬件），以及 Trait 架构、安全默认、AIEOS/订阅 等扩展能力。

功能对比

性能对比（基于 README 基准表）

README 给出的本地可复现基准（归一化到 0.8GHz 边缘设备概念）如下，便于理解量级差异：

• 内存：ZeroClaw 常见 CLI/status 约 3.9–4.1MB 峰值；OpenClaw 需 Node，整体常 >1GB。
• 启动：ZeroClaw 毫秒级；OpenClaw 冷启动（尤其是首次拉依赖/起服务）可达数百秒量级。
• 部署成本：ZeroClaw 面向约 10 美元级板子与小内存 VPS；OpenClaw 更常见于 Mac Mini 或更大实例。

复现方式（README）：cargo build --release 后 ls -lh target/release/zeroclaw，并用 /usr/bin/time -l target/release/zeroclaw --help / zeroclaw status 在本地测量。

何时选 ZeroClaw、何时选 OpenClaw

• 优先选 ZeroClaw：边缘/树莓派/低配 VPS、对内存与冷启动敏感、希望单二进制无 Node、需要从 OpenClaw 迁记忆且保留身份、重视 Trait 可插拔与安全默认、需要 OpenAI Codex/Claude 订阅多账号。
• 优先选 OpenClaw：已深度依赖 OpenClaw Skill 与 Node 生态、需要特定社区 Skill/插件、团队已统一 Node 运维与调试、对「最小内存/最快冷启动」不敏感。

项目详细剖析

架构要点：Trait 与可插拔

README 用表格概括了各子系统及其 Trait、内置实现与扩展方式：

• Provider：内置 28+ 及别名，扩展为 custom:https://... 或 anthropic-custom:https://...
• Channel：多种消息渠道，可接任意消息 API
• Memory：SQLite / Lucid / Markdown / none，可接其他持久化后端
• Tool：shell、file、memory、cron、git、browser、http、composio 等，可扩展
• Runtime：native 或 Docker（沙箱）；未来计划 WASM/edge
• Security：配对、沙箱、白名单、速率限制、工作区与敏感路径限制
• Identity：OpenClaw（Markdown）或 AIEOS v1.1（JSON）
• Tunnel：none、Cloudflare、Tailscale、ngrok、自定义

配置以 ~/.zeroclaw/config.toml 为主，由 onboard 生成；API Key 等可加密存于 ~/.zeroclaw/。

记忆与 OpenClaw 迁移

• 记忆层：SQLite 内向量 + FTS5 关键词、混合加权、EmbeddingProvider Trait、LRU 缓存、安全重建索引。
• zeroclaw migrate openclaw：从 OpenClaw 导出并导入记忆到 ZeroClaw，支持 --dry-run 预览。

安全与 Gateway

• Gateway 默认仅绑定 127.0.0.1；需公网访问时需配合隧道（Tailscale、Cloudflare、ngrok 等）或显式 allow_public_bind。
• 配对：启动时 6 位一次性码，通过 POST /pair 换 Bearer Token；Webhook 需在请求头中携带 Authorization: Bearer <你的 token>（尖括号为占位，实际填写配对得到的 token）。
• 渠道白名单：空即拒绝所有；"*" 为显式允许全部；推荐按 Telegram/Discord 等 ID 精确放行。
• 工作区限定、禁止敏感路径、Docker 沙箱等见 README 安全清单与配置说明。

项目地址与资源

• 🌟 GitHub: github.com/zeroclaw-labs/zeroclaw
• 📚 文档: 仓库内 docs/README.md、docs/SUMMARY.md、commands/config/channels 等
• 🐛 Issues: GitHub Issues
• 🔗 相关: OpenClaw 主仓库, AIEOS