OpenClaw VPS セットアップ（Docker + 安全接続）

OpenClaw VPS セットアップ（Docker + 安全接続）

これは OpenClaw を安定運用するための代表的な本番構成です。Gateway を VPS 上で 24/7 動かし、Control UI には SSH トンネル経由で接続します。

推奨構成

• Gateway は VPS 上で常時起動
• Control UI は Mac / ローカル端末から SSH トンネル経由で接続
• 18789 をインターネットへ直接公開しない

ssh -N -L 18789:127.0.0.1:18789 user@your-vps-host

Option A: Docker（推奨）

Step 1: システムを更新する

sudo apt update && sudo apt upgrade -y

Step 2: Docker と Compose を導入する

使用中の OS に合わせて Docker Engine と Compose v2 を導入します。

Step 3: Docker 権限を整える

sudo usermod -aG docker $USERnewgrp docker

Step 4: リポジトリを取得する

git clone https://github.com/openclaw/openclaw.gitcd openclaw

Step 5: 公式 Docker セットアップを実行する

./docker-setup.sh

Step 6: CLI コンテナからオンボーディングを完了する

Control UI を開き、トークンを設定してオンボーディングを進めます。

Step 7: ログで状態を確認する

docker compose psdocker compose logs --tail=100

Option B: ネイティブ導入（Docker を使わない）

npm i -g openclaw@latestopenclaw onboard --install-daemon

安全に Control UI へ接続する

一時的なトンネル

ssh -N -L 18789:127.0.0.1:18789 user@your-vps-ip

常時使うトンネル

macOS LaunchAgent や systemd などでトンネルを自動再接続にしておくと安定します。

よくある問題

• 認証なしで公開 bind しようとして拒否される
• サービス設定と Control UI の設定がずれている
• 複数の gateway が競合して EADDRINUSE が出る

必要なら openclaw doctor や openclaw gateway install --force を使って設定を再確認してください。

次に読むべきガイド

• トラブルシューティング
• 高度な設定
• Telegram セットアップ