Raspberry Pi

在 Raspberry Pi 上執行持久、常駐的 OpenClaw 閘道。由於 Pi 只是閘道（模型透過 API 在雲端執行），即使是規格普通的 Pi 也能很好地處理工作負載，典型硬體成本為一次性 35–80 美元，沒有月費。

硬體相容性

最低需求： 1 GB RAM、1 核心、500 MB 可用磁碟空間、64 位元作業系統。 建議配置： 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 分鐘

設定

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Set timezone (important for cron and reminders)sudo timedatectl set-timezone America/Chicago

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

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Reduce swappiness for low-RAM devicesecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

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

openclaw onboard --install-daemon

openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

效能提示

使用 USB SSD -- SD 卡速度慢且容易耗損。USB SSD 能大幅改善效能。請參閱 Pi USB 開機指南。

啟用模組編譯快取 -- 加速低功耗 Pi 主機上的重複命令列介面呼叫：

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

OPENCLAW_NO_RESPAWN=1 會讓例行閘道重新啟動保留在同一程序內，避免額外的程序交接，並讓小型主機上的 PID 追蹤保持簡單。

降低記憶體用量 -- 對於無頭設定，釋放 GPU 記憶體並停用未使用的服務：

echo 'gpu_mem=16' | sudo tee -a /boot/config.txtsudo systemctl disable bluetooth

用於穩定重新啟動的 systemd drop-in -- 如果這台 Pi 主要用於執行 OpenClaw，請加入服務 drop-in：

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

然後執行 systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service。在無頭 Pi 上，也要啟用一次 lingering，讓使用者服務在登出後仍能存活：sudo loginctl enable-linger "$(whoami)"。

建議的模型設定

由於 Pi 只執行閘道，請使用雲端託管的 API 模型：

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

不要在 Pi 上執行本機 LLM，即使小型模型也慢到不實用。讓 Claude 或 GPT 處理模型工作。

ARM 二進位檔注意事項

大多數 OpenClaw 功能可在 ARM64 上無需變更地運作（Node.js、Telegram、WhatsApp/Baileys、Chromium）。偶爾缺少 ARM 建置的二進位檔，通常是 Skills 隨附的選用 Go/Rust 命令列介面工具。在退回從原始碼建置之前，請確認缺少的二進位檔發布頁面是否提供 linux-arm64 / aarch64 artifacts。

持久性與備份

OpenClaw 狀態位於：

• ~/.openclaw/ — openclaw.json、每個 agent 的 auth-profiles.json、頻道/供應商狀態、工作階段。
• ~/.openclaw/workspace/ — agent 工作區（SOUL.md、記憶、artifacts）。

這些會在重新啟動後保留。使用以下命令建立可攜式快照：

openclaw backup create

如果將這些保存在 SSD 上，效能和壽命都會比 SD 卡更好。

疑難排解

記憶體不足 -- 使用 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 等
• 閘道設定 -- 所有設定選項
• 更新 -- 讓 OpenClaw 保持最新

相關

• 安裝概覽
• Linux 伺服器
• 平台