在 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	✅ 可以	能用，需要加 swap
Pi 4	1GB	⚠️ 紧张	加 swap 后可用，最小化配置
Pi 3B+	1GB	⚠️ 慢	能用但比较卡
Pi Zero 2 W	512MB	❌	不推荐

最低配置： 1GB 内存、1 核 CPU、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 连接

ssh user@gateway-host
# 或使用 IP 地址
ssh [email protected]

3) 系统设置

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装必要的软件包
sudo apt install -y git curl build-essential

# 设置时区（对定时任务/提醒很重要）
sudo timedatectl set-timezone America/Chicago  # 改成你的时区

4) 安装 Node.js 22 (ARM64)

# 通过 NodeSource 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证
node --version  # 应该显示 v22.x.x
npm --version

5) 添加 Swap（2GB 或更少内存时很重要）

Swap 可以防止内存不足导致的崩溃：

# 创建 2GB swap 文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 设为永久生效
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# 针对低内存优化（降低 swappiness）
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

6) 安装 OpenClaw

方式 A：标准安装（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

方式 B：可修改安装（用于折腾）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

可修改安装让你能直接访问日志和代码——对调试 ARM 特定问题很有用。

7) 运行引导向导

openclaw onboard --install-daemon

按照向导操作：

Gateway 模式： Local
认证方式： 推荐 API keys（OAuth 在无头 Pi 上可能不稳定）
Channel： Telegram 最容易上手
Daemon： Yes (systemd)

8) 验证安装

# 检查状态
openclaw status

# 检查服务
sudo systemctl status openclaw

# 查看日志
journalctl -u openclaw -f

9) 访问控制面板

由于 Pi 是无头的，使用 SSH 隧道：

# 在你的笔记本/台式机上
ssh -L 18789:localhost:18789 user@gateway-host

# 然后在浏览器中打开
open http://localhost:18789

或者使用 Tailscale 实现随时访问：

# 在 Pi 上
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# 更新配置
openclaw config set gateway.bind tailnet
sudo systemctl restart openclaw

性能优化

使用 USB SSD（大幅提升）

SD 卡速度慢且容易损坏。USB SSD 能显著提升性能：

# 检查是否从 USB 启动
lsblk

参考 Pi USB 启动指南进行设置。

减少内存占用

# 禁用 GPU 内存分配（无头模式）
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt

# 如果不需要蓝牙就禁用
sudo systemctl disable bluetooth

监控资源

# 检查内存
free -h

# 检查 CPU 温度
vcgencmd measure_temp

# 实时监控
htop

ARM 特定说明

二进制兼容性

大多数 OpenClaw 功能在 ARM64 上都能用，但有些外部二进制文件可能需要 ARM 版本：

工具	ARM64 状态	备注
Node.js	✅	运行良好
WhatsApp (Baileys)	✅	纯 JS，没问题
Telegram	✅	纯 JS，没问题
gog (Gmail CLI)	⚠️	检查是否有 ARM 版本
Chromium (browser)	✅	`sudo apt install chromium-browser`

如果某个 Skill 失败了，检查它的二进制文件是否有 ARM64 版本。很多 Go/Rust 工具有，但有些没有。

32 位 vs 64 位

一定要用 64 位系统。 Node.js 和很多现代工具都需要 64 位。检查方法：

uname -m
# 应该显示：aarch64（64 位）而不是 armv7l（32 位）

开机自启

引导向导会设置好这个，但你可以验证一下：

# 检查服务是否已启用
sudo systemctl is-enabled openclaw

# 如果没启用就启用
sudo systemctl enable openclaw

# 开机启动
sudo systemctl start openclaw

故障排除

内存不足（OOM）

# 检查内存
free -h

# 添加更多 swap（参见步骤 5）
# 或减少 Pi 上运行的服务

性能慢

用 USB SSD 代替 SD 卡
禁用不用的服务：sudo systemctl disable cups bluetooth avahi-daemon
检查 CPU 降频：vcgencmd get_throttled（应该返回 0x0）

服务无法启动

# 查看日志
journalctl -u openclaw --no-pager -n 100

# 常见修复：重新构建
cd ~/openclaw  # 如果使用可修改安装
npm run build
sudo systemctl restart openclaw

ARM 二进制问题

如果某个 Skill 失败并显示 “exec format error”：

检查二进制文件是否有 ARM64 版本
尝试从源码构建
或使用支持 ARM 的 Docker 容器

WiFi 掉线

对于使用 WiFi 的无头 Pi：

# 禁用 WiFi 电源管理
sudo iwconfig wlan0 power off

# 设为永久生效
echo 'wireless-power off' | sudo tee -a /etc/network/interfaces

成本对比

方案	一次性成本	月费	备注
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/年

回本时间： Pi 相比云 VPS 大约 6-12 个月就能回本。