OpenClawSkills
GitHub
平台 • 5 分钟阅读

Raspberry Pi

OpenClaw 在 Raspberry Pi 上（预算自托管设置）

Tutorial.step

目标

在 Raspberry Pi 上运行持久、始终在线的 OpenClaw Gateway，一次性成本约为 ~$35-80（无月费）。

适用于：

- 24/7 个人 AI 助手

- 家庭自动化中心

- 低功耗、始终可用的 Telegram/WhatsApp 机器人

Tutorial.step

硬件要求

| 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 核心，500MB 磁盘

推荐： 2GB+ 内存，64 位操作系统，16GB+ SD 卡（或 USB SSD）

Tutorial.step

你需要什么

- Raspberry Pi 4 或 5（推荐 2GB+）

- MicroSD 卡（16GB+）或 USB SSD（性能更好）

- 电源（推荐官方 Pi PSU）

- 网络连接（以太网或 WiFi）

- ~30 分钟

Tutorial.step

1) 刷入操作系统

使用 Raspberry Pi OS Lite (64-bit) — 无头服务器不需要桌面。

1. 下载 ''Raspberry Pi Imager''

2. 选择操作系统：Raspberry Pi OS Lite (64-bit)

3. 点击齿轮图标（⚙️）进行预配置：

- 设置主机名：''gateway-host''

- 启用 SSH

- 设置用户名/密码

- 配置 WiFi（如果不使用以太网）

4. 刷入到你的 SD 卡 / USB 驱动器

5. 插入并启动 Pi

Tutorial.step

2) 通过 SSH 连接

Bash
ssh user@gateway-host

ssh [email protected]
Tutorial.step

3) 系统设置

Bash
sudo apt update && sudo apt upgrade -y


sudo apt install -y git curl build-essential


sudo timedatectl set-timezone America/Chicago  # Change to your timezone
Tutorial.step

4) 安装 Node.js 22 (ARM64)

Bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs


node --version  # Should show v22.x.x
npm --version
Tutorial.step

5) 添加 Swap（对于 2GB 或更少很重要）

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

Bash
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


echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
Tutorial.step

6) 安装 OpenClaw

Tutorial.step

选项 A：标准安装（推荐）

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

选项 B：可破解安装（用于调试）

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

可破解安装使你可以直接访问日志和代码 — 对于调试 ARM 特定问题很有用。

Tutorial.step

7) 运行入门向导

Bash
openclaw onboard --install-daemon

按照向导操作：

1. Gateway 模式： 本地

2. 身份验证： 推荐 API 密钥（OAuth 在无头 Pi 上可能不稳定）

3. 通道： Telegram 最容易开始

4. 守护进程： 是（systemd）

Tutorial.step

8) 验证安装

Bash
openclaw status


sudo systemctl status openclaw


journalctl -u openclaw -f
Tutorial.step

9) 访问仪表板

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

Bash
ssh -L 18789:localhost:18789 user@gateway-host


open http://localhost:18789

或使用 Tailscale 进行始终在线访问：

Bash
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up


openclaw config set gateway.bind tailnet
sudo systemctl restart openclaw
Tutorial.step

ARM 特定说明

Tutorial.step

二进制兼容性

大多数 OpenClaw 功能在 ARM64 上工作，但某些外部二进制文件可能需要 ARM 构建：

| 工具 | ARM64 状态 | 备注 |

| | |

Tutorial.step

推荐的模型设置

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

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

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

Tutorial.step

故障排除

Tutorial.step

内存不足（OOM）

Bash
free -h
Tutorial.step

性能缓慢

- 使用 USB SSD 而不是 SD 卡

- 禁用未使用的服务：''sudo systemctl disable cups bluetooth avahi-daemon''

- 检查 CPU 降频：''vcgencmd get_throttled''（应该返回 ''0x0''）

Tutorial.step

服务无法启动

Bash
journalctl -u openclaw --no-pager -n 100


cd ~/openclaw  # if using hackable install
npm run build
sudo systemctl restart openclaw
Tutorial.step

ARM 二进制问题

如果技能因 "exec format error" 失败：

1. 检查二进制文件是否有 ARM64 构建

2. 尝试从源代码构建

3. 或使用支持 ARM 的 Docker 容器

Tutorial.step

WiFi 掉线

对于使用 WiFi 的无头 Pi：

Bash
sudo iwconfig wlan0 power off


echo 'wireless-power off' | sudo tee -a /etc/network/interfaces
Tutorial.step

另请参阅

- ''Linux 指南'' — 通用 Linux 设置

- ''DigitalOcean 指南'' — 云端替代方案

- ''Hetzner 指南'' — Docker 设置

- ''Tailscale'' — 远程访问

- ''节点'' — 将你的笔记本电脑/手机与 Pi gateway 配对