芯耀
476
感谢 CSDN 作者：Darth Nihilus，辛苦制作的教程，供新人及树莓派爱好者学习使用！
关于 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 进行归一化展示：
说明：ZeroClaw 的数据来自 release 构建，并通过 /usr/bin/time -l 测得。OpenClaw 需要 Node.js 运行时环境，仅该运行时通常就会带来约 390MB 的额外内存占用；NanoBot 需要 Python 运行时环境。PicoClaw 与 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
项目 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/
树莓派CM0 Dev Kit 安装 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
是否可以配置ZeroClaw：不建议
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
是否可以配置ZeroClaw：已验证
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
是否可以配置ZeroClaw：未验证
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
是否可以配置ZeroClaw：未验证
系统更新
sudo apt updatesudo apt upgrade
启动 ssh
sudo systemctl start sshsudo systemctl enable ssh
安装 git
sudo apt install gitInstalling:gitInstalling dependencies:git-man liberror-perlSuggested packages:git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svnSummary:Upgrading: 0, Installing: 3, Removing: 0, Not Upgrading: 0Download size: 10.9 MBSpace needed: 53.1 MB / 4,366 MB availableContinue? [Y/n] YGet: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 仓库
git clone https://github.com/zeroclaw-labs/zeroclaw.gitCloning 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 2Receiving objects: 100% (27358/27358), 27.32 MiB | 3.71 MiB/s, done.Resolving deltas: 100% (18882/18882), done.
一键安装 ZeroClaw
cd zeroclaw./install.sh
显示如下即为 ZeroClaw 安装成功
树莓派CM0 Dev Kit 配置 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”，完成全部配置。
树莓派CM0 Dev Kit ZeroClaw 功能验证
在手机QQ中选择对应QQ机器人输入内容确认 ZeroClaw 功能正常。
官方网站：https://edatec.cn/zh/cm0
淘宝店铺：https://edatec.taobao.com/
