Raspberry Pi

Raspberry Pi で、永続的に常時稼働する OpenClaw Gateway を実行します。Pi は Gateway だけを担い（モデルは API 経由でクラウド上で動作します）、控えめな性能の Pi でも十分に処理できます。一般的なハードウェア費用は $35–80 の一回払いで、月額料金はありません。

# ハードウェア互換性

最小要件: 1 GB RAM、1 コア、500 MB の空きディスク容量、64-bit OS。 推奨: 2 GB+ RAM、16 GB+ SD カード（または USB SSD）、Ethernet。

# 前提条件

• 2 GB+ RAM 搭載の Raspberry Pi 4 または 5（4 GB 推奨）
• MicroSD カード（16 GB+）または USB SSD（より高性能）
• 公式 Pi 電源
• ネットワーク接続（Ethernet または WiFi）
• 64-bit Raspberry Pi OS（必須 -- 32-bit は使用しない）
• 約 30 分

# セットアップ

ssh user@gateway-host

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

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

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

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

openclaw onboard --install-daemon

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --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 ホストで CLI の繰り返し起動を高速化します:

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

メモリ使用量を減らす -- ヘッドレス構成では、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 では、ユーザーサービスがログアウト後も維持されるように、linger も一度有効化します: sudo loginctl enable-linger "$(whoami)"。

# 推奨モデル設定

Pi は Gateway のみを実行するため、クラウドホストの 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 CLI ツールです。ソースからビルドする前に、不足しているバイナリのリリースページで linux-arm64 / aarch64 アーティファクトを確認してください。

# 永続化とバックアップ

OpenClaw の状態は次の場所にあります:

• ~/.openclaw/ — openclaw.json、エージェントごとの auth-profiles.json、チャンネル/プロバイダー状態、セッション。
• ~/.openclaw/workspace/ — エージェントワークスペース（SOUL.md、メモリ、アーティファクト）。

これらは再起動後も維持されます。ポータブルなスナップショットは次で取得します:

openclaw backup create

これらを SSD 上に置くと、SD カードよりもパフォーマンスと寿命の両方が向上します。

# トラブルシューティング

メモリ不足 -- free -h で swap が有効か確認します。未使用のサービスを無効にします（sudo systemctl disable cups bluetooth avahi-daemon）。API ベースのモデルのみを使用します。

パフォーマンスが遅い -- SD カードではなく USB SSD を使用します。vcgencmd get_throttled で CPU スロットリングを確認します（0x0 が返るはずです）。

サービスが起動しない -- journalctl --user -u openclaw-gateway.service --no-pager -n 100 でログを確認し、openclaw doctor --non-interactive を実行します。これがヘッドレス Pi の場合は、linger が有効になっていることも確認します: 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 を最新の状態に保つ

# 関連

• インストール概要
• Linux サーバー
• プラットフォーム