Headless ヘッドレスデプロイメント
ディスプレイ接続不要。SSH リモートで完結
Headless デプロイが必要な人
所謂 Headless は画面・キーボード・マウス非接続、全 SSH 遠隔操作。大多数の人の Raspberry Pi は最終的に角に放置実行、デスクトップ不要。
この記事はビルドから始まる、SSH 接続、OpenClaw デプロイ、ブート自動起動まで、全プロセスに外部デバイス不要。モニター一台と HDMI ケーブル一本のお金を節約。
5 ステップで完結
1
システム焼録
Raspberry Pi Imager で SD カードにシステム焼録、Raspberry Pi OS Lite (64-bit) 選択、デスクトップ不要。
2
SSH 有効化
Imager の高度な設定から直接「Enable SSH」にチェック、ユーザー名とパスワード設定すれば、手動でファイル作成する手間が不要。
3
WiFi を設定
Imager 詳細設定で WiFi 名とパス入力。ネット線あるなら直接接続が便利。
4
初回接続
SD カード Raspberry Pi に挿入通電起動、1-2 分待機してネットワーク接続、その後 SSH 接続。
5
OpenClaw をデプロイ
SSH に接続した後は普通の Linux と同じ操作で、Docker をインストール、compose を実行、完成。
Raspberry Pi Imager 設定
Imager ツールは今とても使いやすくなっています、書き込み時に SSH、WiFi、ユーザー名を直接設定します：
Raspberry Pi Imager アドバンスド設定
# 1. Raspberry Pi Imager をダウンロードしてインストールSSH 接続
焼録完了カード挿入通電、1-2 分待機してネット接続、その後ローカルから SSH 接続：
SSH キー生成と最初のログイン
# SSH キーがまだない場合は生成起動時自動開始
Raspberry Pi 停電再起動後、OpenClaw 自動起動期待、手動 SSH 接続起動不要。systemd で管理：
systemd サービス作成
# サービスファイルを作成
openclaw.service systemd サービスファイル
[Unit]
Description=OpenClaw Docker Compose Service
Requires=docker.service
After=docker.service network-online.target
Wants=network-online.target
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/home/pi/openclaw
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
ExecReload=/usr/bin/docker compose restart
TimeoutStartSec=120
[Install]
WantedBy=multi-user.target
開機自動起動有効化
# systemd 設定をリロード
固定 IP で見失い防止：Raspberry Pi はデフォルト DHCP で自動取得、ルーター再起動後 IP が変わるかも、SSH が繋がらなくなる。ルーターで Raspberry Pi に固定 IP をバインド、またはボード上で静的 IP を設定することをおすすめ：編集
/etc/dhcpcd.conf、加えて static ip_address=192.168.1.100/24。
SSH で接続した後クイックデプロイメント
SSH に接続したら、下のコマンドで一路進む：
ワンクリックデプロイフロー
# システムを更新