zeroclaw

ZeroClaw 是由 ZeroClaw Labs 发起并持续维护的开源 AI 个人助手基础设施，核心定位是“一个能塞进树莓派的超轻量 AI Agent 运行时——你拥有 Agent、拥有数据、拥有它运行的每一台机器”——它不满足于做一份 OpenClaw 的简单复刻或零散的 Agent 工具集，而是将 22+ LLM 提供商、30+ 消息通道、多后端记忆存储、工具调用与沙箱执行、硬件能力（GPIO/I2C/SPI）、SOP 事件引擎、ACP 协议集成等核心能力整合于一套完整的开源运行时中，全部配有单一 Rust 二进制（3.4–8.8MB）、zeroclaw quickstart 一键启动、Web Dashboard 可视化面板、完整的基准测试体系以及 Apache-2.0 开源协议。市面大多 AI Agent 框架要么是 TypeScript/Node 的重型方案（内存 300MB 起步、依赖链复杂），要么是依赖特定云服务的黑盒平台——但很少有项目能将“极致轻量的资源占用”与“完整的企业级 Agent 能力”同时做到，ZeroClaw 解决的正是这个问题。

一、ZeroClaw 是什么

ZeroClaw 采用“单一 Rust 二进制 + 配置文件驱动 + 多端部署”三位一体的使用体验，通过 GitHub 完全开源发布，采用 Apache-2.0 许可证。项目由 ZeroClaw Labs 发起并持续维护，核心定位是“OpenClaw 的极致轻量替代”——整个项目最终产物就是一个二进制文件：你给它一份配置，它就能把 LLM 提供商、消息通道、记忆存储、工具调用四件事串起来跑成一个自治助手。项目截至 2026 年 7 月已获得 30,000+ GitHub Stars、143 个 release，并已进入 Arch Linux 官方仓库。官方提供完整的 Docs 文档站、哲学说明 和 Discord 社区。

ZeroClaw 的运作机制与市面常见的“重型 Agent 框架”或“云端依赖平台”有本质区别。它不是让用户部署一套复杂的 Node.js 服务（430k 行 TypeScript + 海量 npm 依赖），而是一套以四个 Rust Trait 为核心、编译期组装、配置文件驱动的 Agent 运行时。系统的核心抽象是四个 Trait：

• Provider：抽象 LLM 提供商，支持 Anthropic、OpenAI、Ollama、OpenRouter 等 ~22 家，统一处理各家不同的 function/tool calling 协议、流式响应差异、上下文窗口与截断策略、重试与限流

• Channel：抽象消息平台，支持 Discord、Telegram、Matrix、邮件、语音、Webhook、CLI 等 30+ 通道——一个 Agent 在你配置的每一个通道上回答你

• Memory：抽象存储后端，支持 SQLite + FTS5、Postgres（pgvector）、本地文件

• Tool：抽象外部能力，支持 Shell、浏览器、HTTP、硬件、自定义 MCP Server

所有扩展点都是 Rust Trait，实现散落在不同 crate 里，按 feature flag 编进二进制；配置文件只决定用哪一个实现，不决定怎么加载。换 LLM、换通道、换数据库，改 config 就行，不动代码。

二、ZeroClaw 能做什么

ZeroClaw 的核心能力可以精炼地概括为：轻、连、安、硬、协，围绕这五大维度提供了从单机部署到全平台运行的完整路径，覆盖 AI Agent 基础设施的全方位需求，具体包括：

极致轻量的资源占用（轻） ——不是“300MB 起步的重型服务”，而是“能塞进树莓派的超轻量二进制”。ZeroClaw 的单一 Rust 二进制体积仅 3.4–8.8MB（看构建配置），长跑内存 < 5MB，冷启动 < 10ms（官方数据，硬件低至 0.6GHz 也能跑）。运行时内存占用仅 7.8MB，比 OpenClaw 低了近 200 倍。默认 deny-by-default 的工具白名单 + 路径白名单，把“Agent 运行时”做成“一个能塞进树莓派的二进制”。

多通道统一接入（连） ——不是“每个平台单独配置一个 Agent”，而是“一个 Agent 在 30+ 通道上回答你”。来自 Discord、Telegram、Matrix、邮件、Webhook、CLI 的入站消息全部交付到同一个 Agent 循环。同时提供 HTTP/WebSocket Gateway + Web Dashboard，支持聊天、记忆浏览、配置编辑、cron 管理和工具检查。

安全优先的沙箱执行（安） ——不是“Agent 能碰任何东西”，而是“默认监督、高风险操作需审批”。默认自治模式为 supervised：中风险操作需审批，高风险操作被阻止。支持工作区边界、命令策略、OS 级沙箱（Landlock/Bubblewrap/Seatbelt/Docker），以及每个工具调用上的加密工具收据。同时提供 YOLO 模式供可信开发环境使用。

硬件能力与边缘部署（硬） ——不是“只能在服务器上跑”，而是“能跑在树莓派、STM32、Arduino 和 ESP32 上”。通过 Peripheral Trait 支持 GPIO/I2C/SPI/USB，让 Agent 可以直接与物理世界交互。受益于极致的轻量简便，可以部署到任意服务器、树莓派或低配云主机上。

SOP 事件引擎与 ACP 协议集成（协） ——不是“只能被动响应”，而是“事件触发的标准化操作流程”。SOP 引擎支持 MQTT/Webhook/Cron/Peripheral 触发，带审批门和可恢复运行。ACP（Agent Client Protocol）提供 IDE/编辑器集成，通过 JSON-RPC 2.0 over stdio 实现。支持 Provider 故障时的回退链和路由，保持 Agent 在提供商波动时继续运行。

三、ZeroClaw 适合谁用

ZeroClaw 的内容设计使其适配各类希望在轻量级基础设施上运行自主 AI Agent 的开发者与团队，核心聚焦那些“OpenClaw 功能强大但资源占用令人窒息、想在树莓派或低配云主机上长期运行 Agent”，希望从“重型 Node.js 服务”升级为“极致轻量的 Rust 二进制”的人群，主要涵盖以下几类：

边缘计算与 IoT 开发者——希望在树莓派、STM32、Arduino、ESP32 等低功耗设备上运行 AI Agent。ZeroClaw 的 <5MB 内存占用和 <10ms 冷启动，让 Agent 可以在 0.6GHz 的硬件上流畅运行。

自托管与隐私优先的用户——不想把数据上传到第三方云端，希望在自己的服务器上运行完全自主的 AI 助手。ZeroClaw 的“你拥有 Agent、拥有数据、拥有它运行的每一台机器”的哲学，以及完全自托管的部署方式，让数据主权得到保障。

OpenClaw 的性能敏感用户——正在使用 OpenClaw 但对其 300MB+ 内存占用和复杂依赖链感到困扰的开发者。ZeroClaw 作为“OpenClaw 的极致轻量替代”，提供了相同的 Agent 能力但资源占用降低了近 200 倍。

DevOps 与基础设施工程师——需要将 AI Agent 集成到现有的监控、告警、自动化工作流中。ZeroClaw 的 SOP 事件引擎（MQTT/Webhook/Cron 触发）、30+ 通道支持和 systemd/launchctl/Windows Service 注册能力，让 Agent 可以无缝融入现有基础设施。

AI Agent 开发者与研究者——希望研究或构建基于 Rust 的 Agent 运行时。ZeroClaw 的四个 Trait 架构（Provider/Channel/Memory/Tool）提供了清晰的扩展点，编译期组装的设计让运行时不会出现“插件签名对不上”的错误。

四、ZeroClaw 的应用场景是什么

基于其内容设计与定位，ZeroClaw 的应用场景主要围绕个人 AI 助手部署、边缘 AI 与 IoT、企业级 Agent 基础设施和 AI 研究实验，覆盖从个人开发到企业级部署的多个场景，具体包括：

个人 AI 助手 24/7 部署场景——用户希望拥有一个 24 小时待命的全功能 AI 助手，可以在 Discord、Telegram、邮件等多个平台上同时响应。ZeroClaw 提供了一条“zeroclaw quickstart 一键配置 → 选择 LLM 提供商和通道 → zeroclaw daemon 后台运行 → zeroclaw status 随时查看状态”的完整路径。受益于 <5MB 的内存占用，可以在低配云主机上长期运行而无需担心资源成本。

树莓派与边缘设备 AI 场景——开发者希望在树莓派上运行一个能够控制 GPIO、读取传感器、响应语音指令的本地 AI 助手。ZeroClaw 的硬件能力（GPIO/I2C/SPI/USB）和极致轻量的资源占用，让 Agent 可以直接在边缘设备上运行并与物理世界交互。

企业级多通道 Agent 基础设施场景——企业希望建立一个统一的 AI Agent 入口，让员工可以通过 Slack、Teams、邮件等多种渠道与同一个 Agent 交互。ZeroClaw 的 30+ 通道支持和 Provider 故障回退链，为企业级部署提供了高可用性和统一入口。

安全敏感的自动化工作流场景——团队需要在执行敏感操作（如文件访问、命令执行）时有审批门禁。ZeroClaw 的 supervised 默认模式（中风险需审批、高风险被阻止）和工具收据加密签名，让自动化工作流在安全可控的前提下运行。

AI Agent 运行时研究与实验场景——研究者需要研究 Agent 运行时的内部机制、多 Provider 路由策略或沙箱隔离方案。ZeroClaw 的完全开源、四个 Trait 的清晰架构和编译期组装的确定性，为研究提供了可随意拆解和改造的实验平台。

五、ZeroClaw 为什么值得关注

ZeroClaw 之所以值得关注，核心在于它将“AI Agent 运行时从重型 Node.js 服务升级为极致轻量、编译期安全、配置文件驱动的 Rust 二进制”，并具备“30k+ Stars 社区认可、<5MB 内存占用、22+ LLM × 30+ 通道 × 硬件能力、Apache-2.0 开源”的独特价值，具体体现在以下几点：

从“300MB 内存”到“<5MB 内存”的资源革命。OpenClaw 那套 TypeScript/Node.js 栈，常被吐槽两件事：资源占用大（常驻内存动辄 300MB 起步）、依赖链复杂（430k 行 TypeScript + 海量 npm 依赖）。ZeroClaw 的反向选择就很直接：单一 Rust 二进制体积 3.4–8.8MB、长跑内存 < 5MB、冷启动 < 10ms。运行时内存占用仅 7.8MB，比 OpenClaw 低了近 200 倍。把“Agent 运行时”做成“一个能塞进树莓派的二进制”，是它最容易被记住的点。

从“运行时插件”到“编译期 Trait”的安全哲学。很多 Agent 框架走的是“运行时插件 + 动态加载”的路——Python 的 entry points、Node 的 require 注入。ZeroClaw 反过来——编译期组装：所有扩展点都是 Trait，实现按 feature flag 编进二进制，配置文件只决定用哪一个实现，不决定怎么加载。好处很 Rust：编译器帮你做契约校验，运行时不会出现“插件签名对不上”这种错误。默认 deny-by-default 的工具白名单 + 路径白名单，让安全不是事后补丁而是架构级设计。

从“单一模型锁定”到“22+ Provider × 30+ Channel × 硬件能力”的覆盖广度。大多数 Agent 工具只支持一两种 LLM 或一两个消息平台。ZeroClaw 支持 22+ LLM 提供商（Anthropic、OpenAI、Ollama、OpenRouter 等）、30+ 消息通道（Discord、Telegram、Matrix、邮件、语音、Webhook、CLI 等）、硬件能力（GPIO/I2C/SPI/USB 支持树莓派/STM32/Arduino/ESP32）。Provider 故障回退链和路由让 Agent 在提供商波动时继续运行。这种“模型无关、通道无关、硬件无关”的开放架构，让用户不会被任何单一生态锁定。

30,000+ Stars + 143 releases + Arch Linux 官方仓库的社区认可。ZeroClaw 在 GitHub 上获得 30,000+ Stars 和 143 个 release，已进入 Arch Linux 官方仓库。项目提供完整的文档站、哲学说明、Discord 社区和贡献指南。这种“社区驱动 + 持续迭代”的模式，确保了项目的长期生命力。

Apache-2.0 开源 + 全平台覆盖 + 一键安装。ZeroClaw 采用 Apache-2.0 许可证，完全开源免费可商用。支持 Linux、macOS、Windows、FreeBSD、NixOS 和 Docker 全平台部署。安装只需一行命令：curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh。macOS 用户还可通过 Homebrew 安装：brew install zeroclaw。

现实挑战与生态成熟度。ZeroClaw 并非没有短板。首先，编译期组装的架构意味着新增 Provider/Channel 一般需要重新编译——不像动态插件系统那样可以热加载。其次，项目定位是“极致轻量替代”，在某些高级编排功能上可能不如 OpenClaw 丰富。再次，项目由社区主导维护，虽然通过 Apache-2.0 和完整的文档体系降低了使用门槛，但核心迭代节奏受限于社区贡献者的精力。最后，项目早期曾出现过多个复刻仓库（如 xzh-icenter/zeroclaw、openagen/zeroclaw 等），用户在安装时需确认使用的是官方仓库 zeroclaw-labs/zeroclaw。