（六）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 | 未验证 |
系统更新
sudoaptupdatesudoaptupgrade启动 ssh
sudosystemctl startsshsudosystemctlenablessh安装 git
sudoaptinstallgitInstalling:gitInstalling 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:0Download size:10.9MB Space needed:53.1MB /4,366MB available Continue?[Y/n]Y Get:1 http://deb.debian.org/debian trixie/main arm64 liberror-perl all0.17030-1[26.9kB]Get:2 http://deb.debian.org/debian trixie/main arm64 git-man all1:2.47.3-0+deb13u1[2,205kB]Get:3 http://deb.debian.org/debian trixie/main arm64gitarm641:2.47.3-0+deb13u1[8,666kB]Fetched10.9MBin45s(241kB/s)Selecting previously unselected package liberror-perl.(Reading database...65918files 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... Unpackinggit(1:2.47.3-0+deb13u1)... Setting up liberror-perl(0.17030-1)... Setting up git-man(1:2.47.3-0+deb13u1)... Setting upgit(1:2.47.3-0+deb13u1)... Processing triggersforman-db(2.13.1-1)...拉取 ZeroClaw 仓库
gitclone 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: Total27358(delta72), reused97(delta51), pack-reused27164(from2Receiving objects:100%(27358/27358),27.32MiB|3.71MiB/s, done. Resolving deltas:100%(18882/18882), done.一键安装 ZeroClaw
cdzeroclaw ./install.sh
