在树莓派 Zero 上跑一只轻量级的 ZeroClaw 小龙虾

推荐语

在树莓派 Zero 2 W 上运行轻量级 ZeroClaw 小龙虾，体验极简高效的嵌入式开发！

核心内容：
1. ZeroClaw 的轻量级优势：Rust 二进制文件仅 3.4MB，无依赖
2. 树莓派 Zero 2 W 的硬件配置与网络连接优化建议
3. 从系统烧录到 SSH 连接的完整设置指南

杨芳贤

53AI创始人/腾讯云(TVP)最具价值专家

ZeroClaw 在树莓派 Zero 2 W 上表现出色——它是一个单一的 Rust 二进制文件，无需运行时，也没有动态依赖。启动速度更快，二进制文件大约只有 3.4 MB，内存占用极低。

相比之下，OpenClaw 是一个 Node.js 应用，拥有大量 npm 模块和动态依赖，这让它在小型开发板上显得更为沉重。ZeroClaw 是自包含的，专为此类场景而生。

概览

本文使用的是树莓派 Zero 2 W，通过 USB 转以太网适配器和 OTG 转接器接入有线网络。Zero 上的 Wi-Fi 模块在处理大型更新时可能会出现延迟，因此建议在初始配置阶段将其直接连接到路由器，之后再切回 Wi-Fi。

推荐准备一套包含外壳、散热片、OTG 线缆的套件，如果需要连接显示器还需准备一根 HDMI 转接线。64 GB microSD 卡即可满足需求，同时还需要一根 Cat 5 或 Cat 6 网线。

烧录操作系统

我们将为 Pi Zero 2 W 烧录 64 位 Raspberry Pi OS，以确保与静态 aarch64 ZeroClaw 二进制文件兼容。由于该板只有512 MB 内存和较弱的 CPU，第一次启动时需要耐心等待。

Imager 配置步骤

1. 打开 Raspberry Pi Imager

2. 选择设备：Raspberry Pi Zero 2 W

3. 选择系统：Raspberry Pi OS 64-bit

4. 设置主机名，例如 claw

5. 设置用户名（如 zero）并配置一个强密码

6. 如果后续需要无线网络，配置 Wi-Fi 的 SSID 和密码（初始设置推荐有线）7. 启用 SSH，选择公钥认证方式

SSH 密钥配置

在主机上生成 ed25519 SSH 密钥，然后将公钥粘贴到 Imager 中。

检查是否已有密钥：

ls -l ~/.ssh/id_ed25519.pub

如不存在，生成新密钥：

ssh-keygen -t ed25519 -C "zeroclaw-to-mac"

复制公钥内容：

cat ~/.ssh/id_ed25519.pub

将公钥粘贴到 Imager 的 SSH 配置项中并保存。

Raspberry Pi Connect

在 Imager 中启用 Raspberry Pi Connect，便于后续远程访问。根据提示使用你的树莓派账户创建或获取认证 Token，然后将镜像写入 SD 卡并安全弹出。

首次启动与 SSH 连接

组装套件，插入 SD 卡，通过 OTG 适配器连接 USB 网卡并接入路由器，然后为 Pi Zero 2 W 上电。首次启动大约需要 5 分钟。使用 Raspberry Pi Connect 确认设备已出现，然后打开远程终端获取 IP。

在 Pi 上获取 IP 地址：

hostname -I

从主机 SSH 连接：

ssh zero@<YOUR_PI_IP>

确认主机密钥提示并完成认证。如果只启用了公钥认证，系统将自动使用私钥，密码登录已被禁用。

系统基础配置

更新软件包元数据：

sudo apt update

升级软件包：

sudo apt upgrade -y

安装必要工具：

sudo apt install -y curl rsync

安装 Tailscale

按照 Tailscale 文档中的 Linux 安装命令在 Pi 上安装 Tailscale。安装完成后，将节点上线：

sudo tailscale up

将终端中显示的登录 URL 复制到浏览器，登录你的 Tailscale 账户并批准该设备。在 Tailscale 管理控制台中，复制该设备在「Addresses」下显示的 Tailscale IP，便于后续远程访问。

使用模力方舟的算力

模力方舟是可以完美支持 ZeroClaw 和 OpenClaw 的，ZeroClaw 只需要在 config.toml 中增加如下配置项即可，包括： api_key, default_provider 和 default_model 。

小结

ZeroClaw 的静态 Rust 二进制文件、极小的体积和低内存占用，使其非常适合树莓派 Zero 2 W。配合 64 位 Raspberry Pi OS、仅限公钥的 SSH、Raspberry Pi Connect 和 Tailscale，你将拥有一个干净、安全的基础环境来运行 ZeroClaw。首次启动和升级时耐心等待，之后你就拥有了一个稳定的小型主机，随时准备好运行 ZeroClaw。