在 Raspberry Pi 上运行 OpenClaw
目标
在 Raspberry Pi 上运行持久、常驻的 OpenClaw Gateway 网关,一次性成本约 $35-80(无月费)。 适用于:- 24/7 个人 AI 助手
- 家庭自动化中心
- 低功耗、随时可用的 Telegram/WhatsApp 机器人
硬件要求
| Pi 型号 | 内存 | 是否可用? | 说明 |
|---|---|---|---|
| Pi 5 | 4GB/8GB | ✅ 最佳 | 最快,推荐 |
| Pi 4 | 4GB | ✅ 良好 | 大多数用户的最佳选择 |
| Pi 4 | 2GB | ✅ 可以 | 可用,添加交换空间 |
| Pi 4 | 1GB | ⚠️ 紧张 | 使用交换空间可行,最小配置 |
| Pi 3B+ | 1GB | ⚠️ 慢 | 可用但较慢 |
| Pi Zero 2 W | 512MB | ❌ | 不推荐 |
推荐: 2GB+ 内存,64 位系统,16GB+ SD 卡(或 USB SSD)
你需要准备
- Raspberry Pi 4 或 5(推荐 2GB+)
- MicroSD 卡(16GB+)或 USB SSD(性能更好)
- 电源(推荐官方 Pi 电源)
- 网络连接(以太网或 WiFi)
- 约 30 分钟
1) 刷写系统
使用 Raspberry Pi OS Lite (64-bit) — 无头服务器不需要桌面。- 下载 Raspberry Pi Imager
- 选择系统:Raspberry Pi OS Lite (64-bit)
- 点击齿轮图标(⚙️)预配置:
- 设置主机名:
gateway-host - 启用 SSH
- 设置用户名/密码
- 配置 WiFi(如果不使用以太网)
- 设置主机名:
- 刷写到你的 SD 卡 / USB 驱动器
- 插入并启动 Pi
2) 通过 SSH 连接
3) 系统设置
4) 安装 Node.js 22(ARM64)
5) 添加交换空间(2GB 或更少内存时很重要)
交换空间可防止内存不足崩溃:6) 安装 OpenClaw
选项 A:标准安装(推荐)
选项 B:可修改安装(用于调试)
7) 运行新手引导
- Gateway 网关模式: Local
- 认证: 推荐 API 密钥(OAuth 在无头 Pi 上可能不稳定)
- 渠道: Telegram 最容易上手
- 守护进程: 是(systemd)
8) 验证安装
9) 访问仪表板
由于 Pi 是无头的,使用 SSH 隧道:性能优化
使用 USB SSD(巨大改进)
SD 卡速度慢且会磨损。USB SSD 可大幅提升性能:减少内存使用
监控资源
ARM 特定说明
二进制兼容性
大多数 OpenClaw 功能在 ARM64 上可用,但某些外部二进制文件可能需要 ARM 构建:| 工具 | ARM64 状态 | 说明 |
|---|---|---|
| Node.js | ✅ | 运行良好 |
| WhatsApp (Baileys) | ✅ | 纯 JS,无问题 |
| Telegram | ✅ | 纯 JS,无问题 |
| gog (Gmail CLI) | ⚠️ | 检查是否有 ARM 版本 |
| Chromium (browser) | ✅ | sudo apt install chromium-browser |
32 位 vs 64 位
始终使用 64 位系统。 Node.js 和许多现代工具需要它。使用以下命令检查:推荐的模型设置
由于 Pi 只是 Gateway 网关(模型在云端运行),使用基于 API 的模型:开机自启
新手引导向导会设置这个,但要验证:故障排除
内存不足(OOM)
性能慢
- 使用 USB SSD 代替 SD 卡
- 禁用未使用的服务:
sudo systemctl disable cups bluetooth avahi-daemon - 检查 CPU 降频:
vcgencmd get_throttled(应返回0x0)
服务无法启动
ARM 二进制问题
如果某个 skill 失败并显示”exec format error”:- 检查该二进制文件是否有 ARM64 构建
- 尝试从源代码构建
- 或使用支持 ARM 的 Docker 容器
WiFi 断开
对于使用 WiFi 的无头 Pi:成本对比
| 设置 | 一次性成本 | 月费 | 说明 |
|---|---|---|---|
| Pi 4 (2GB) | ~$45 | $0 | + 电费(约 $5/年) |
| Pi 4 (4GB) | ~$55 | $0 | 推荐 |
| Pi 5 (4GB) | ~$60 | $0 | 最佳性能 |
| Pi 5 (8GB) | ~$80 | $0 | 过剩但面向未来 |
| DigitalOcean | $0 | $6/月 | $72/年 |
| Hetzner | $0 | €3.79/月 | 约 $50/年 |
另请参阅
- Linux 指南 — 通用 Linux 设置
- DigitalOcean 指南 — 云替代方案
- Hetzner 指南 — Docker 设置
- Tailscale — 远程访问
- 节点 — 将你的笔记本电脑/手机与 Pi Gateway 网关配对