什么是 ZeroClaw？

简介

ZeroClaw 是一个面向 Agentic 工作流的运行时操作系统 — 一个轻量级、trait 驱动的自主 AI Agent 构建和部署基础设施。完全使用 Rust 编写，它抽象了模型、工具、记忆和执行层，使 Agent 可以在任何地方以最小开销部署。

项目标语完美概括了它的特点："快速、轻量、完全自主的 AI 助手基础设施 — 随处部署，任意替换。"

与需要数 GB 内存的重量级框架不同，ZeroClaw 可以在 $10 的硬件上以不到 5MB 的内存运行 — 比 OpenClaw 少 99% 的内存。其 8.8MB 的单二进制 Rust 运行时可在 10 毫秒内实现近即时冷启动。

为什么选择 ZeroClaw？

AI Agent 领域正在快速增长，但大多数框架使用 Python 或 TypeScript 构建 — 在边缘硬件和大规模场景下性能表现不佳。ZeroClaw 采用了根本不同的方法：

• 默认轻量：在 $10 的开发板上运行，内存不到 5MB，比同类框架少 99%。
• 安全架构：基于配对的网关、严格沙箱、显式白名单、工作空间隔离和静态加密凭证。
• 完全可替换：每个核心子系统都实现了 trait 接口 — Provider、通道、工具、记忆、隧道、运行时和可观测性均可替换。
• 极速冷启动：单二进制 Rust 运行时在 10ms 内启动 — 无预热、无 JIT、无垃圾回收器。
• 成本高效：专为树莓派、嵌入式系统和小型云实例设计。
• Provider 无关：兼容 OpenAI 端点和自定义 Provider — 连接 OpenAI、Anthropic、OpenRouter 或任何自定义端点，无供应商锁定。

Trait 驱动架构

ZeroClaw 的核心特色是其 trait 驱动设计。每个子系统都可以通过通用的 trait 接口进行替换：

| 子系统 | Trait | 默认实现 | |--------|-------|---------| | AI 模型 | Provider | OpenAI、Anthropic、OpenRouter、自定义端点 | | 通道 | Channel | CLI、Telegram、Discord、Slack、Matrix、Signal、iMessage、WhatsApp、Email、Webhook 及 9+ 更多 | | 记忆 | Memory | SQLite 混合搜索、PostgreSQL、Markdown 文件、无记忆 | | 工具 | Tool | Shell、文件操作、git、浏览器、HTTP、截图、硬件 | | 运行时 | RuntimeAdapter | 原生、Docker 沙箱 | | 可观测性 | Observer | 日志、多观察者 | | 隧道 | Tunnel | Cloudflare、Tailscale、ngrok、自定义 |

这意味着您可以替换任何组件 — 使用 Anthropic 替代 OpenAI、PostgreSQL 替代 SQLite、Tailscale 替代 Cloudflare — 无需修改您的 Agent 逻辑。

记忆系统

ZeroClaw 内置了一个零外部依赖的全栈搜索引擎 — 无需 Pinecone、Elasticsearch 或 LangChain：

• 向量存储：SQLite BLOB 存储嵌入向量，支持余弦相似度搜索。
• 关键词搜索：FTS5 虚拟表配合 BM25 评分，实现基于文本的检索。
• 混合合并：向量和关键词结果的加权组合，获得最佳准确度。
• 嵌入 Provider：基于 trait — 支持 OpenAI 嵌入、自定义 URL 端点或禁用模式。
• 分块：基于行的 Markdown 分块，保留标题信息以实现上下文感知的分割。
• 缓存：SQLite embedding_cache 表中的 LRU 淘汰策略，加速重复查询。

可选的记忆后端包括 PostgreSQL、Markdown 文件或无记忆 — 通过配置选择。

15+ 消息通道

ZeroClaw 支持部署到多种消息平台：

• 聊天：CLI、Telegram、Discord、Slack、Mattermost
• 加密通道：Signal、iMessage、WhatsApp
• 企业通道：Matrix、飞书（Lark）、钉钉（DingTalk）、Nostr
• Web：Email、IRC、Webhook、QQ、Linq

每个通道都实现了 Channel trait，使添加新集成变得简单。

安装

使用以下方法之一安装 ZeroClaw：

Homebrew（macOS/Linux）：

brew install zeroclaw

一键引导：

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./bootstrap.sh

从源码编译：

cargo build --release --locked
cargo install --path . --force --locked

预编译二进制文件可从 GitHub Releases 下载，支持 Linux（x86_64、aarch64、armv7）、macOS（x86_64、aarch64）和 Windows（x86_64）。

前置要求

• Linux/macOS：构建工具、pkg-config、Rust 工具链
• Windows：Visual Studio Build Tools（桌面 C++ 开发）、通过 rustup 安装 Rust
• 编译要求：最低 2GB RAM + swap，6GB 可用磁盘空间；推荐 4GB+ RAM，10GB+ 磁盘空间

配置

ZeroClaw 通过 ~/.zeroclaw/config.toml（TOML 格式）进行配置。配置涵盖：

• Provider 选择和认证
• 通道设置和白名单
• 记忆后端（SQLite、PostgreSQL、Markdown、无记忆）
• 运行时类型（原生或 Docker）
• 安全策略和速率限制
• 自定义工具定义
• 隧道和身份配置

认证模式

• API 密钥：加密存储在 ~/.zeroclaw/auth-profiles.json
• OpenAI Codex OAuth：设备码或浏览器回调流程
• Claude Code/Anthropic：设置令牌和订阅认证
• 多配置文件支持：格式 <provider>:<profile_name>

核心 CLI 用法

# 引导配置（交互式或脚本式）
zeroclaw onboard --interactive
zeroclaw onboard --api-key sk-... --provider openrouter

# 聊天交互
zeroclaw agent -m "你的消息"
zeroclaw agent  # 交互模式

# 启动网关/守护进程
zeroclaw gateway
zeroclaw daemon

# 系统诊断
zeroclaw status
zeroclaw doctor

性能基准（2026 年 2 月）

| 指标 | ZeroClaw | PicoClaw | NanoBot | OpenClaw | |------|----------|---------|---------|----------| | 语言 | Rust | Go | Python | TypeScript | | 运行时内存 | <5MB | <10MB | >100MB | >1GB | | 启动时间 (0.8GHz) | <10ms | <1s | >30s | >500s | | 二进制大小 | 8.8MB | ~8MB | N/A | ~28MB |

启动时间基于边缘硬件标准化；对比假设标准化负载。

安全模型

ZeroClaw 非常重视安全性，提供多层保护：

• 基于配对的网关用于安全多用户访问
• 工作空间隔离：Agent 被限制在指定目录内
• 加密凭证：凭据静态加密存储
• 白名单：通道和工具的显式权限规则
• 速率限制：内置滥用保护
• 沙箱运行时：可选的基于 Docker 的隔离环境

使用场景

ZeroClaw 适用于：

• 自主编码 Agent，可读取、编写和测试代码
• 研究管道，用于收集、总结和综合信息
• 客服机器人，可访问内部系统工具
• DevOps 自动化 Agent，用于基础设施管理
• 边缘部署 — 在嵌入式硬件和 IoT 设备上运行 Agent
• 多通道机器人 — 一个 Agent 横跨 Telegram、Discord、Slack 等平台

下一步

• 查看最新版本下载 ZeroClaw
• 阅读 ZeroClaw 与 OpenClaw 对比
• 访问官方文档获取详细参考