OpenClawSkills
GitHub
プラットフォーム • 5分で読める

Raspberry Pi

OpenClaw on Raspberry Pi (budget self-hosted setup)

Tutorial.step

Goal

Raspberry Pi 上で永続的な、常時オンの OpenClaw Gateway を ~$35-80 の一回限りのコストで実行します（月額料金なし）。

次に最適です：

- 24/7 個人 AI アシスタント

- ホームオートメーションハブ

- 低電力、常時利用可能な Telegram/WhatsApp ボット

Tutorial.step

ハードウェア要件

| Pi モデル | RAM | 動作？ | 備考 |

| - |

| Pi 5 | 4GB/8GB | ✅ Best | Fastest, recommended |

| Pi 4 | 4GB | ✅ 良好 | ほとんどのユーザーに最適 |

| Pi 4 | 2GB | ✅ OK | 動作します、swap を追加 |

| Pi 4 | 1GB | ⚠️ きつい | swap で可能、最小構成 |

| Pi 3B+ | 1GB | ⚠️ 遅い | 動作しますが遅い |

| Pi Zero 2 W | 512MB | ❌ | 推奨されません |

最低スペック： 1GB RAM、1 コア、500MB ディスク

推奨： 2GB+ RAM、64 ビット OS、16GB+ SD カード（または USB SSD）

Tutorial.step

必要なもの

- Raspberry Pi 4 または 5（2GB+ 推奨）

- MicroSD カード（16GB+）または USB SSD（パフォーマンス向上）

- Power supply (official Pi PSU recommended)

- ネットワーク接続（イーサネットまたは WiFi）

- ~30 minutes

Tutorial.step

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 を設定（イーサネットを使用しない場合）

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

See Also

- ''Linux ガイド'' — 一般的な Linux 設定

- ''DigitalOcean ガイド'' — クラウドの代替案

- ''Hetzner ガイド'' — Docker 設定

- ''Tailscale'' — リモートアクセス

- ''ノード'' — ラップトップ/電話を Pi ゲートウェイとペアリング