GCP

gcloud CLI をインストールする（または Console を使用する）

オプション A: gcloud CLI（自動化に推奨）

https://cloud.google.com/sdk/docs/install からインストールします。

初期化して認証します。

gcloud init
gcloud auth login

オプション B: Cloud Console

すべての手順は https://console.cloud.google.com の Web UI から実行できます。

GCP プロジェクトを作成する

CLI:

gcloud projects create my-openclaw-project --name="OpenClaw Gateway"
gcloud config set project my-openclaw-project

https://console.cloud.google.com/billing で課金を有効にします（Compute Engine に必要）。

Compute Engine API を有効にします。

gcloud services enable compute.googleapis.com

Console:

1. IAM & Admin > Create Project に移動する
2. 名前を付けて作成する
3. プロジェクトの課金を有効にする
4. APIs & Services > Enable APIs に移動し、「Compute Engine API」を検索して有効にする

VM を作成する

マシンタイプ:

CLI:

gcloud compute instances create openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small \
  --boot-disk-size=20GB \
  --image-family=debian-12 \
  --image-project=debian-cloud

Console:

1. Compute Engine > VM instances > Create instance に移動する
2. 名前: openclaw-gateway
3. リージョン: us-central1、ゾーン: us-central1-a
4. マシンタイプ: e2-small
5. ブートディスク: Debian 12、20GB
6. 作成する

VM に SSH する

CLI:

gcloud compute ssh openclaw-gateway --zone=us-central1-a

Console:

Compute Engine ダッシュボードで VM の横にある「SSH」ボタンをクリックします。

注: SSH 鍵の反映には VM 作成後 1〜2 分かかることがあります。接続が拒否された場合は、待ってから再試行してください。

Docker をインストールする（VM 上）

sudo apt-get update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

グループ変更を反映するためにログアウトして再ログインします。

exit

その後、再度 SSH します。

gcloud compute ssh openclaw-gateway --zone=us-central1-a

確認します。

docker --version
docker compose version

OpenClaw リポジトリをクローンする

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

このガイドでは、バイナリの永続性を保証するためにカスタムイメージをビルドすることを前提としています。

永続的なホストディレクトリを作成する

Docker コンテナは一時的なものです。 長期間保持する状態はすべてホスト上に置く必要があります。

mkdir -p ~/.openclaw
mkdir -p ~/.openclaw/workspace

環境変数を設定する

リポジトリルートに .env を作成します。

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/home/$USER/.openclaw
OPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace

GOG_KEYRING_PASSWORD=
XDG_CONFIG_HOME=/home/node/.openclaw

安定した Gateway トークンを .env 経由で管理したい場合は OPENCLAW_GATEWAY_TOKEN を設定します。そうでない場合は、再起動をまたいでクライアントを利用する前に gateway.auth.token を設定してください。どちらのソースも存在しない場合、OpenClaw はその起動時のみ有効なランタイムトークンを使用します。キーリングパスワードを生成して GOG_KEYRING_PASSWORD に貼り付けます。

openssl rand -hex 32

このファイルをコミットしないでください。

この .env ファイルは、OPENCLAW_GATEWAY_TOKEN などのコンテナ/ランタイム環境変数用です。 保存されたプロバイダー OAuth/API キー認証は、マウントされた ~/.openclaw/agents/<agentId>/agent/auth-profiles.json に格納されます。

Docker Compose 設定

docker-compose.yml を作成または更新します。

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - TERM=xterm-256color
      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      # Recommended: keep the Gateway loopback-only on the VM; access via SSH tunnel.
      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
        "--allow-unconfigured",
      ]

--allow-unconfigured はブートストラップ時の利便性のためだけのもので、適切な Gateway 設定の代替ではありません。認証（gateway.auth.token またはパスワード）は必ず設定し、デプロイに対して安全なバインド設定を使用してください。

共有 Docker VM ランタイム手順

一般的な Docker ホストフローには、共有ランタイムガイドを使用してください。

• 必要なバイナリをイメージに組み込む
• ビルドして起動する
• 何がどこに永続化されるか
• 更新

GCP 固有の起動メモ

GCP で、pnpm install --frozen-lockfile 中にビルドが Killed または exit code 137 で失敗する場合、VM のメモリが不足しています。最小でも e2-small を使用するか、初回ビルドの信頼性を高めるには e2-medium を使用してください。

LAN にバインドする場合（OPENCLAW_GATEWAY_BIND=lan）、続行する前に信頼済みブラウザーオリジンを設定します。

docker compose run --rm openclaw-cli config set gateway.controlUi.allowedOrigins '["http://127.0.0.1:18789"]' --strict-json

Gateway ポートを変更した場合は、18789 を設定したポートに置き換えてください。

ラップトップからアクセスする

Gateway ポートを転送する SSH トンネルを作成します。

gcloud compute ssh openclaw-gateway --zone=us-central1-a -- -L 18789:127.0.0.1:18789

ブラウザーで開きます。

http://127.0.0.1:18789/

クリーンなダッシュボードリンクを再表示します。

docker compose run --rm openclaw-cli dashboard --no-open

UI が共有シークレット認証を求める場合は、設定済みのトークンまたは パスワードを Control UI 設定に貼り付けます。この Docker フローはデフォルトでトークンを書き込みます。コンテナ設定をパスワード認証に切り替えた場合は、代わりにその パスワードを使用してください。

Control UI に unauthorized または disconnected (1008): pairing required が表示される場合は、ブラウザーデバイスを承認します。

docker compose run --rm openclaw-cli devices list
docker compose run --rm openclaw-cli devices approve <requestId>

共有永続化と更新のリファレンスをもう一度確認する必要がありますか？ Docker VM Runtime と Docker VM Runtime の更新 を参照してください。