树莓派CM0零成本部署ZeroClaw:内存占用降低99%的AI代理运行时指南
ZeroClaw是一个专为资源受限环境设计的高性能、低占用、可组合的自主智能体运行时。它本质上是一个面向智能代理工作流的运行时操作系统,通过抽象模型、工具、记忆和执行层,实现了“一次构建,随处运行”的愿景。

关于 ZeroClaw 的核心特性

项目设计理念
ZeroClaw 旨在为智能代理提供一个极其高效的基础运行平台。它采用 Rust 语言原生编写,生成单一二进制文件,能够无缝部署在 ARM、x86 及 RISC-V 等多种架构上。其核心是 Trait 驱动的模块化架构,允许开发者灵活替换 Provider(模型供应商)、Channel(通信渠道)、Tool(工具)和 Memory(记忆存储)等组件。系统设计将安全性置于首位,默认启用配对鉴权、显式白名单机制以及沙箱与作用域约束。
选择 ZeroClaw 的五大理由
- 极致轻量:常规命令行操作与状态监控工作流仅需数 MB 内存,资源消耗极低。
- 部署成本友好:专为低成本开发板与小规格云主机优化,无需依赖庞大臃肿的运行时环境。
- 迅捷的冷启动:得益于 Rust 编译的单一二进制特性,常用命令与守护进程的启动速度接近“秒开”。
- 卓越的跨平台能力:同一套二进制流程可覆盖 ARM、x86、RISC-V 架构,同时保持核心组件的可插拔性。
- 安全优先的设计哲学:内置多重安全机制,为智能体操作提供可靠保障。
性能基准对比(ZeroClaw vs. 其他方案)
以下是在本地进行的快速基准测试数据(基于 macOS arm64 平台,2026年2月),并已按 0.8GHz 边缘CPU性能进行归一化处理,确保结果可横向比较:

补充说明:ZeroClaw 的数据来自其发布版构建,并通过 /usr/bin/time -l 命令测得。作为对比,OpenClaw 需要 Node.js 运行时环境,仅此一项通常就会引入约 390MB 的额外内存开销;NanoBot 则依赖 Python 运行时。而 PicoClaw 与 ZeroClaw 同为静态二进制文件,无需外部运行时。
模块化架构解析
ZeroClaw 的每个核心子系统都定义为一个 Trait(特性)。这意味着用户仅需通过修改配置,即可更换不同子系统的实现,无需触及核心代码。


官方文档索引
- 文档总览(英文):docs/README.md
- 统一目录(TOC):docs/SUMMARY.md
- 文档总览(简体中文):docs/README.zh-CN.md
- 命令参考:docs/reference/cli/commands-reference.md
- 配置参考:docs/reference/api/config-reference.md
- Provider 参考:docs/reference/api/providers-reference.md
- Channel 参考:docs/reference/api/channels-reference.md
- 运维手册:docs/ops/operations-runbook.md
- 故障排查:docs/ops/troubleshooting.md
- 文档清单与分类:docs/maintainers/docs-inventory.md
- 项目状态快照(2026-02-18):docs/maintainers/project-triage-snapshot-2026-02-18.md
(以上内容整理自 ZeroClaw 官方 GitHub 仓库:https://github.com/zeroclaw-labs/zeroclaw)
如需了解更多,请访问 ZeroClaw 官方网站:https://www.zeroclawlabs.ai/
在树莓派 CM0 Dev Kit 上安装 ZeroClaw
第一步:选择兼容的操作系统
-
Raspberry Pi OS(桌面版)64-bit-trixie (Debian 13): https://downloads.raspberrypi.com/raspios_arm64/images/raspios_arm64-2025-10-02/2025-10-01-raspios-trixie-arm64.img.xz ZeroClaw 兼容性:不推荐。
-
Raspberry Pi OS(精简版)64-bit-trixie (Debian 13): https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2025-10-02/2025-10-01-raspios-trixie-arm64-lite.img.xz ZeroClaw 兼容性:已验证可行。
-
Raspberry Pi OS(桌面版)32-bit-trixie (Debian 13): https://downloads.raspberrypi.com/raspios_armhf/images/raspios_armhf-2025-10-02/2025-10-01-raspios-trixie-armhf.img.xz ZeroClaw 兼容性:未经验证。
-
Raspberry Pi OS(精简版)32-bit-trixie (Debian 13): https://downloads.raspberrypi.com/raspios_lite_armhf/images/raspios_lite_armhf-2025-10-02/2025-10-01-raspios-trixie-armhf-lite.img.xz ZeroClaw 兼容性:未经验证。
第二步:执行系统更新
sudo apt update
sudo apt upgrade
第三步:启用 SSH 服务
sudo systemctl start ssh
sudo systemctl enable ssh
第四步:安装 Git
sudo apt install git
安装过程将显示类似以下信息:
Installing: git
Installing dependencies: git-man liberror-perl
Suggested packages: git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn
Summary: Upgrading: 0, Installing: 3, Removing: 0, Not Upgrading: 0
Download size: 10.9 MB
Space needed: 53.1 MB / 4,366 MB available
Continue? [Y/n] Y
...(后续下载与安装详情)...
第五步:克隆 ZeroClaw 仓库
git clone https://github.com/zeroclaw-labs/zeroclaw.git
输出将显示克隆进度:
Cloning into 'zeroclaw'...
remote: Enumerating objects: 27358, done.
remote: Counting objects: 100% (194/194), done.
remote: Compressing objects: 100% (142/142), done.
remote: Total 27358 (delta 72), reused 97 (delta 51), pack-reused 27164
Receiving objects: 100% (27358/27358), 27.32 MiB | 3.71 MiB/s, done.
Resolving deltas: 100% (18882/18882), done.
第六步:运行一键安装脚本
cd zeroclaw
./install.sh
安装成功后,终端将显示确认信息。

配置树莓派 CM0 上的 ZeroClaw
配置 AI 模型供应商
在配置向导的 [2/9] AI Provider & API Key 步骤中,选择 Recommended(OpenRouter, Venice, Anthropic, OpenAI, Gemini)。

接着选择 OpenRouter — 200+ models, 1 API key (recommended)。

输入您从 OpenRouter 获取的 API KEY,并根据需求选择合适的模型。

配置 QQ 机器人通道
首先,在浏览器中访问 QQ 开放平台:https://q.qq.com/qqbot/openclaw/login.html。

使用手机 QQ 扫描页面上的二维码进行登录。

点击“创建机器人”,填写相关信息后确认创建。

创建后,点击“扫码聊天”,再次使用手机 QQ 扫描二维码即可添加机器人好友并打开聊天窗口。

回到树莓派终端,在配置向导的 [3/9] Channels 步骤中,选择 QQ Official - Tencent QQ Bot。

在 QQ 开放平台的机器人管理页面,找到 AppID 和 AppSecret,将其复制并粘贴到 ZeroClaw 的配置中。

完成此步骤后,选择 Done - finish setup。
完成其余配置项
-
[4/9] Tunnel:选择Skip。
-
[5/9] Tool Mode & Security:选择Sovereign。
-
[6/9] Hardware:选择Native。
-
[7/9] Memory Configuration:选择SQLite with Vector Search。
-
[8/9] Project Context:按提示输入Your name、Your timezone、Agent name。
-
[9/9] Workspace Files:确认生成的配置文件信息。
-
最后,确认所有信息无误后,输入
Y完成全部配置。
功能验证
配置完成后,在手机 QQ 中向刚刚添加的机器人发送消息。如果机器人能够正常接收并回复,则表明 ZeroClaw 已在树莓派 CM0 上成功部署并运行。
