コンテンツへスキップ
最終更新

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

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

推奨構成

  • Gateway は VPS 上で常時起動
  • Control UI は Mac / ローカル端末から SSH トンネル経由で接続
  • 18789 をインターネットへ直接公開しない
Command
ssh -N -L 18789:127.0.0.1:18789 user@your-vps-host

Option A: Docker（推奨）

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

Command
sudo apt update && sudo apt upgrade -y

Step 2: Docker と Compose を導入する

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

Step 3: Docker 権限を整える

Command
sudo usermod -aG docker $USERnewgrp docker

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

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

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

Command
./docker-setup.sh

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

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

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

Command
docker compose psdocker compose logs --tail=100

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

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

安全に Control UI へ接続する

一時的なトンネル

Command
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 を使って設定を再確認してください。

次に読むべきガイド