メインコンテンツへスキップ
Raspberry Pi 上で永続的に常時稼働する OpenClaw Gateway を実行します。Pi は Gateway にすぎないため（モデルは API 経由でクラウド上で実行されます）、控えめな Pi でもこのワークロードを十分に処理できます。一般的なハードウェア費用は 一度きりで $35-80、月額料金はありません。

​
ハードウェア互換性

Pi モデルRAM動作するか注記
Pi 54/8 GB最適最速、推奨。
Pi 44 GB良好ほとんどのユーザーに最適。
Pi 42 GBOKswap を追加。
Pi 41 GB厳しいswap と最小構成なら可能。
Pi 3B+1 GB低速動作するがもたつきます。
Pi Zero 2 W512 MB不可推奨しません。
最小要件: 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 分

​
セットアップ

1

OS を書き込む

Raspberry Pi OS Lite (64-bit) を使用します — ヘッドレスサーバーにデスクトップは不要です。
  1. Raspberry Pi Imager をダウンロードします。
  2. OS を選択: Raspberry Pi OS Lite (64-bit)。
  3. 設定ダイアログで、事前に構成します:
    • ホスト名: gateway-host
    • SSH を有効化
    • ユーザー名とパスワードを設定
    • WiFi を構成（Ethernet を使わない場合）
  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
ウィザードに従います。ヘッドレスデバイスでは OAuth より API キーを推奨します。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
/tmp ではなく /var/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 では、ユーザーサービスがログアウト後も残るように、linger も一度有効化します: 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/ — エージェントワークスペース（SOUL.md、メモリ、アーティファクト）。
これらは再起動後も保持され、パフォーマンスと寿命の両面で SD カードより SSD の恩恵を受けます。ポータブルスナップショットを作成するには: 
openclaw backup create

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

メモリ不足 — 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。

​
次のステップ

​
関連