在树莓派上运行OpenClaw

目标

在树莓派上运行永续?始终在线*?OpenClaw Gateway?一次性成本约 $35-80*（无月费）?

适合场景?

• 7x24 个人 AI 助手
• 家庭自动化中?
• 低功耗、始终可用的 Telegram/WhatsApp 机器?

硬件要求

最低规格： 1GB 内存? 核，500MB 磁盘 *推荐? 2GB+ 内存?4 位操作系统，16GB+ SD 卡（?USB SSD?

您需要准备的内容

• 树莓?4 ?5（推?2GB+?
• MicroSD 卡（16GB+）或 USB SSD（性能更好?
• 电源（推荐官?Pi PSU?
• 网络连接（以太网?WiFi?
• ?30 分钟

1) 烧录操作系统

使用 Raspberry Pi OS Lite?4 位） ?无需桌面环境，适合无头服务器?

1. 下载 Raspberry Pi Imager
2. 选择操作系统?Raspberry Pi OS Lite (64-bit)*
3. 点击齿轮图标（⚙️）进行预配置：
   • 设置主机名：gateway-host
   • 启用 SSH
   • 设置用户?密码
   • 配置 WiFi（如果不用以太网?
4. 烧录到您?SD ?USB 驱动?
5. 插入并启?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

# 设置时区（对 cron/提醒很重要）
sudo timedatectl set-timezone Asia/Shanghai  # 更改为您所在的时区

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?GB 或更低内存时重要?

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

按照向导操作?

1. *Gateway 模式? 本地
2. *认证? 推荐 API 密钥（OAuth 在无?Pi 上可能不稳定?
3. *渠道? Telegram 最容易上手
4. *守护进程? 是（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 构建版本?

如果某个技能失败，检查其二进制文件是否有 ARM 构建版本。许?Go/Rust 工具有；有些没有?

32 ?vs 64 ?

*始终使用 64 位操作系统? Node.js 和许多现代工具需要它。检查方法：

uname -m
# 应显示：aarch64?4 位）而非 armv7l?2 位）

推荐模型配置

由于 Pi 只是 Gateway（模型在云端运行），使用基于 API 的模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514",
        "fallbacks": ["openai/gpt-4o-mini"]
      }
    }
  }
}

不要尝试?Pi 上运行本?LLM ?即使是小模型也太慢。让 Claude/GPT 做繁重的工作?

启动时自动运?

初始化向导会进行设置，但可以验证?

# 检查服务是否已启用
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 二进制问?

如果某个技能失败并显示 “exec format error”?

1. 检查该二进制文件是否有 ARM64 构建版本
2. 尝试从源代码构建
3. 或使用支?ARM ?Docker 容器

WiFi 断连

对于使用 WiFi 的无?Pi?

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

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

成本对比

盈亏平衡点： Pi 在约 6-12 个月内即可收回成本，相比?VPS?

另请参阅

• Linux 指南 ?通用 Linux 设置
• DigitalOcean 指南 ?云端替代方案
• Hetzner 指南 ?Docker 设置
• Tailscale ?远程访问
• 节点 ?将您的笔记本电脑/手机?Pi Gateway 配对