在 Raspberry Pi 上运行 OpenClaw
目标
在 Raspberry Pi 上运行持久、常驻的 OpenClaw Gateway 网关,一次性成本约 $35-80(无月费)。 适用于:- 24/7 个人 AI 助手
- 家庭自动化中心
- 低功耗、随时可用的 Telegram/WhatsApp 机器人
硬件要求
最低配置: 1GB 内存,1 核,500MB 磁盘
推荐: 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 构建:
如果某个 skill 失败,检查其二进制文件是否有 ARM 构建。许多 Go/Rust 工具有;有些没有。
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:成本对比
回本期: 与云 VPS 相比,Pi 约 6-12 个月内回本。
另请参阅
- Linux 指南 — 通用 Linux 设置
- DigitalOcean 指南 — 云替代方案
- Hetzner 指南 — Docker 设置
- Tailscale — 远程访问
- 节点 — 将你的笔记本电脑/手机与 Pi Gateway 网关配对