Skip to main content
在 Raspberry Pi 上运行一个持久、常开的 OpenClaw Gateway 网关。由于 Pi 只是 Gateway 网关（模型通过 API 在云端运行），即使是配置一般的 Pi 也能很好地处理负载——典型硬件成本为一次性 35-80 美元，没有月费。

​
硬件兼容性

Pi 型号RAM可用？说明
Pi 54/8 GB最佳最快，推荐。
Pi 44 GB良好适合大多数用户的甜点配置。
Pi 42 GB可用添加 swap。
Pi 41 GB吃紧配合 swap 和最小配置可以使用。
Pi 3B+1 GB慢可用但迟缓。
Pi Zero 2 W512 MB否不推荐。
最低要求： 1 GB RAM、1 个核心、500 MB 可用磁盘、64 位 OS。 推荐： 2 GB+ RAM、16 GB+ SD 卡（或 USB SSD）、以太网。

​
前提条件

  • 配备 2 GB+ RAM 的 Raspberry Pi 4 或 5（推荐 4 GB）
  • MicroSD 卡（16 GB+）或 USB SSD（性能更好）
  • 官方 Pi 电源
  • 网络连接（以太网或 WiFi）
  • 64 位 Raspberry Pi OS（必需——不要使用 32 位）
  • 大约 30 分钟

​
设置

1

刷写 OS

使用 Raspberry Pi OS Lite（64 位）——无头服务器不需要桌面环境。
  1. 下载 Raspberry Pi Imager。
  2. 选择 OS：Raspberry Pi OS Lite（64 位）。
  3. 在设置对话框中预先配置：
    • 主机名：gateway-host
    • 启用 SSH
    • 设置用户名和密码
    • 配置 WiFi（如果不使用以太网）
  4. 刷写到你的 SD 卡或 USB 驱动器，插入并启动 Pi。
2

通过 SSH 连接

ssh user@gateway-host
3

更新系统

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Set timezone (important for cron and reminders)
sudo timedatectl set-timezone America/Chicago
4

安装 Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

添加 swap（对 2 GB 或更少内存很重要）

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

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

安装 OpenClaw

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

运行新手引导

openclaw onboard --install-daemon
按照向导操作。对于无头设备，推荐使用 API keys 而不是 OAuth。Telegram 是最容易开始使用的渠道。
8

验证

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

访问 Control UI

在你的电脑上，从 Pi 获取仪表盘 URL：
ssh user@gateway-host 'openclaw dashboard --no-open'
然后在另一个终端中创建 SSH 隧道：
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
在本地浏览器中打开打印出的 URL。对于常开的远程访问，请参阅 Tailscale 集成。

​
性能建议

使用 USB SSD——SD 卡速度慢且会磨损。USB SSD 可以显著提升性能，并承受更多写入周期；如果你把 OS 保留在 SD 卡上，请将其用于 OPENCLAW_STATE_DIR。参阅 Pi USB 启动指南。 启用模块编译缓存——加速低功耗 Pi 主机上的重复 CLI 调用。OPENCLAW_NO_RESPAWN=1 会让常规 Gateway 网关重启保持在进程内，避免额外进程交接，并让小型主机上的 PID 跟踪保持简单： 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
使用 /var/tmp，不要使用 /tmp——有些发行版会在启动时清理 /tmp，这会丢失预热缓存。 减少内存使用——对于无头设置，释放 GPU 内存并禁用未使用的服务： 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
用于稳定重启的 systemd drop-in——如果这个 Pi 主要用于运行 OpenClaw，请添加一个服务 drop-in： 
systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
然后运行 systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service。在无头 Pi 上，还要启用一次 lingering，让用户服务在登出后继续存在：sudo loginctl enable-linger "$(whoami)"。

​
推荐模型设置

由于 Pi 只运行 Gateway 网关，请使用云托管 API 模型——不要在 Pi 上运行本地 LLM，即使小模型也太慢，难以实用： 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}

​
ARM 二进制说明

大多数 OpenClaw 功能可在 ARM64 上无需改动运行（Node.js、Telegram、WhatsApp/Baileys、Chromium）。偶尔缺少 ARM 构建的二进制文件通常是 Skills 附带的可选 Go/Rust CLI 工具。用 uname -m 验证架构（应显示 aarch64），然后在回退到从源代码构建之前，检查缺失二进制文件的发布页面是否有 linux-arm64 / aarch64 构件。

​
持久化和备份

OpenClaw 状态位于：
  • ~/.openclaw/——openclaw.json、每个智能体的 auth-profiles.json、渠道/提供商状态、会话。
  • ~/.openclaw/workspace/——Agent 工作区（SOUL.md、记忆、构件）。
这些内容会在重启后保留，并且使用 SSD 而不是 SD 卡能同时提升性能和寿命。使用以下命令创建可移植快照： 
openclaw backup create

​
故障排查

内存不足——用 free -h 验证 swap 是否已启用。禁用未使用的服务（sudo systemctl disable cups bluetooth avahi-daemon）。仅使用基于 API 的模型。 性能缓慢——使用 USB SSD 而不是 SD 卡。用 vcgencmd get_throttled 检查 CPU 降频（应返回 0x0）。 服务无法启动——用 journalctl --user -u openclaw-gateway.service --no-pager -n 100 检查日志，并运行 openclaw doctor --non-interactive。如果这是无头 Pi，还要验证 lingering 已启用：sudo loginctl enable-linger "$(whoami)"。 ARM 二进制问题——如果某个 skill 因 “exec format error” 失败，请检查该二进制文件是否有 ARM64 构建。用 uname -m 验证架构（应显示 aarch64）。 WiFi 掉线——禁用 WiFi 电源管理：sudo iwconfig wlan0 power off。

​
后续步骤

  • 渠道——连接 Telegram、WhatsApp、Discord 等
  • Gateway 配置——所有配置选项
  • 更新——让 OpenClaw 保持最新

​
相关内容