(六)Raspberry Pi Compute Module Zero Development Board 部署 ZeroClaw

关于 ZeroClaw

项目简介
ZeroClaw 是一个高性能、低资源占用、可组合的自主智能体运行时。ZeroClaw 是面向智能代理工作流的运行时操作系统 --- 它抽象了模型、工具、记忆和执行层,使代理可以一次构建、随处运行。
- Rust 原生实现:单二进制部署,跨 ARM / x86 / RISC-V。
- Trait 驱动架构:Provider / Channel / Tool / Memory 可替换。
- 安全默认值优先:配对鉴权、显式 allowlist、沙箱与作用域约束。
为什么选择 ZeroClaw
- 默认轻量运行时:常见 CLI 与 status 工作流通常保持在几 MB 级内存范围。
- 低成本部署友好:面向低价板卡与小规格云主机设计,不依赖厚重运行时。
- 冷启动速度快:Rust 单二进制让常用命令与守护进程启动更接近"秒开"。
- 跨架构可移植:同一套二进制优先流程覆盖 ARM / x86 / RISC-V,并保持 provider/channel/tool 可替换。
基准快照(ZeroClaw vs OpenClaw,可复现)
以下是本地快速基准对比(macOS arm64,2026 年 2 月),按 0.8GHz 边缘 CPU 进行归一化展示:
| OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | |
|---|---|---|---|---|
| 语言 | TypeScript | Python | Go | Rust |
| RAM | > 1GB | > 100MB | < 10MB | < 5MB |
| 启动时间(0.8GHz 核) | > 500s | > 30s | < 1s | < 10ms |
| 二进制体积 | ~28MB(dist) | N/A(脚本) | ~8MB | ~8.8 MB |
| 成本 | Mac Mini $599 | Linux SBC ~$50 | Linux 板卡 $10 | 任意 $10 硬件 |
- 说明:ZeroClaw 的数据来自 release 构建,并通过 /usr/bin/time -l 测得。OpenClaw 需要 Node.js 运行时环境,仅该运行时通常就会带来约 390MB 的额外内存占用;NanoBot 需要 Python 运行时环境。PicoClaw 与 ZeroClaw 为静态二进制。

架构
每个子系统都是一个 Trait --- 通过配置切换即可更换实现,无需修改代码。

| 子系统 | Trait | 内置实现 | 扩展方式 |
|---|---|---|---|
| AI 模型 | Provider | 通过 zeroclaw providers 查看(当前 28 个内置 + 别名,以及自定义端点) | custom:https://your-api.com(OpenAI 兼容)或 anthropic-custom:https://your-api.com |
| 通道 | Channel | CLI, Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, Linq, Email, IRC, Lark, DingTalk, QQ, Webhook | 任意消息 API |
| 记忆 | Memory | SQLite 混合搜索, PostgreSQL 后端, Lucid 桥接, Markdown 文件, 显式 none 后端, 快照/恢复, 可选响应缓存 | 任意持久化后端 |
| 工具 | Tool | shell/file/memory, cron/schedule, git, pushover, browser, http_request, screenshot/image_info, composio (opt-in), delegate, 硬件工具 | 任意能力 |
| 可观测性 | Observer | Noop, Log, Multi | Prometheus, OTel |
| 运行时 | RuntimeAdapter | Native, Docker(沙箱) | 通过 adapter 添加;不支持的类型会快速失败 |
| 安全 | SecurityPolicy | Gateway 配对, 沙箱, allowlist, 速率限制, 文件系统作用域, 加密密钥 | --- |
| 身份 | IdentityConfig | OpenClaw (markdown), AIEOS v1.1 (JSON) | 任意身份格式 |
| 隧道 | Tunnel | None, Cloudflare, Tailscale, ngrok, Custom | 任意隧道工具 |
| 心跳 | Engine | HEARTBEAT.md 定期任务 | --- |
| 技能 | Loader | TOML 清单 + SKILL.md 指令 | 社区技能包 |
| 集成 | Registry | 9 个分类下 70+ 集成 | 插件系统 |
文档导航
- 文档总览(英文):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
- 项目 triage 快照(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/
Raspberry Pi Compute Module Zero Development Board 安装 ZeroClaw
操作系统选择
| 序号 | 操作系统 | 下载地址 | 是否可以配置ZeroClaw |
|---|---|---|---|
| 1 | Raspberry Pi OS(Desktop) 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 | 不建议 |
| 2 | Raspberry Pi OS(Lite) 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 | 已验证 |
| 3 | Raspberry Pi OS(Desktop) 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 | 未验证 |
| 4 | Raspberry Pi OS(Lite) 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 | 未验证 |
系统更新
bash
sudo apt update
sudo apt upgrade
启动 ssh
bash
sudo systemctl start ssh
sudo systemctl enable ssh
安装 git
bash
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
Get:1 http://deb.debian.org/debian trixie/main arm64 liberror-perl all 0.17030-1 [26.9 kB]
Get:2 http://deb.debian.org/debian trixie/main arm64 git-man all 1:2.47.3-0+deb13u1 [2,205 kB]
Get:3 http://deb.debian.org/debian trixie/main arm64 git arm64 1:2.47.3-0+deb13u1 [8,666 kB]
Fetched 10.9 MB in 45s (241 kB/s)
Selecting previously unselected package liberror-perl.
(Reading database ... 65918 files and directories currently installed.)
Preparing to unpack .../liberror-perl_0.17030-1_all.deb ...
Unpacking liberror-perl (0.17030-1) ...
Selecting previously unselected package git-man.
Preparing to unpack .../git-man_1%3a2.47.3-0+deb13u1_all.deb ...
Unpacking git-man (1:2.47.3-0+deb13u1) ...
Selecting previously unselected package git.
Preparing to unpack .../git_1%3a2.47.3-0+deb13u1_arm64.deb ...
Unpacking git (1:2.47.3-0+deb13u1) ...
Setting up liberror-perl (0.17030-1) ...
Setting up git-man (1:2.47.3-0+deb13u1) ...
Setting up git (1:2.47.3-0+deb13u1) ...
Processing triggers for man-db (2.13.1-1) ...
拉取 ZeroClaw 仓库
bash
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 (from 2
Receiving objects: 100% (27358/27358), 27.32 MiB | 3.71 MiB/s, done.
Resolving deltas: 100% (18882/18882), done.
一键安装 ZeroClaw
bash
cd zeroclaw
./install.sh
显示如下即为 ZeroClaw 安装成功

Raspberry Pi Compute Module Zero Development Board 配置 ZeroClaw
ZeroClaw 模型配置
在"[2/9] AI Provider & API Key"中选择"Recommended(OpenRouter, Venice, Anthropic, OpenAI, Gemini)";

选择"OpenRouter --- 200+ models, 1 API key (recommended)";

输入"API KEY",并选择对应的模型。

ZeroClaw QQ机器人配置
在浏览器中打开QQ开放平台"https://q.qq.com/qqbot/openclaw/login.html";

通过手机QQ扫描登录QQ开放平台;

点击"创建机器人"创建新的QQ机器人,并设置QQ机器人相关信息后点击"确认";

点击"扫码聊天",使用手机QQ扫描二维码添加QQ机器人即可进入聊天窗口;

在"[3/9] Channels"中选择"QQ Official - Tencent QQ Bot";

复制QQ机器人的"AppID"及"AppSecret"至ZeroClaw;

选择"Done - finish setup"完成配置。
ZeroClaw 其他配置
在"[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",完成全部配置。

Raspberry Pi Compute Module Zero Development Board ZeroClaw 功能验证
在手机QQ中选择对应QQ机器人输入内容确认 ZeroClaw 功能正常。
