OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

GCP

Docker を使用して GCP Compute Engine VM 上で永続的な OpenClaw Gateway を実行します。永続化された状態、イメージに組み込まれたバイナリ、安全な再起動動作を備えます。

料金はマシンタイプとリージョンによって異なります。ワークロードに適合する最小の VM を選び、OOM が発生した場合はスケールアップしてください。

Gateway には、ノートパソコンから SSH ポートフォワーディング経由でアクセスできます。また、ファイアウォールとトークンを自身で管理する場合は、ポートを直接公開してアクセスすることもできます。

このガイドでは GCP Compute Engine 上の Debian を使用します。Ubuntu も使用できますが、パッケージは適宜読み替えてください。汎用的な Docker の手順については、Dockerを参照してください。

必要なもの

  • GCP アカウント（e2-micro は無料枠の対象）
  • gcloud CLI、または Cloud Console
  • ノートパソコンからの SSH アクセス
  • Docker と Docker Compose
  • モデルの認証情報
  • 任意のプロバイダー認証情報（WhatsApp QR、Telegram ボットトークン、Gmail OAuth）
  • 約 20～30 分

簡単な手順

  1. GCP プロジェクトを作成し、請求先設定と Compute Engine API を有効にする
  2. Compute Engine VM（e2-small、Debian 12、20GB）を作成する
  3. VM に SSH 接続し、Docker をインストールする
  4. OpenClaw リポジトリをクローンする
  5. 永続化するホストディレクトリを作成する
  6. .env と docker-compose.yml を設定する
  7. 必要なバイナリをイメージに組み込み、ビルドして起動する

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

    cloud.google.com/sdk/docs/installからインストールし、次を実行します。

    bash
    gcloud initgcloud auth login

    または、以下のすべての手順を Cloud Console のウェブ UI から実行します。

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

    bash
    gcloud projects create my-openclaw-project --name="OpenClaw Gateway"gcloud config set project my-openclaw-projectgcloud services enable compute.googleapis.com

    console.cloud.google.com/billing で請求先設定を有効にします（Compute Engine に必要です）。

    Console での同等の操作：IAM & Admin > Create Project でプロジェクトを作成して請求先設定を有効にし、次に APIs & Services > Enable APIs > "Compute Engine API" > Enable を選択します。

  • VM を作成する

    タイプ 仕様 コスト 備考
    e2-medium 2 vCPU、4GB RAM 約 $25/月 ローカルでの Docker ビルドに最も確実
    e2-small 2 vCPU、2GB RAM 約 $12/月 Docker ビルドに推奨される最小構成
    e2-micro 2 vCPU（共有）、1GB RAM 無料枠の対象 Docker ビルドが OOM（終了コード 137）で失敗しやすい
    bash
    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

  • VM に SSH 接続する

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

    Console：Compute Engine ダッシュボードで VM の横にある "SSH" をクリックします。

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

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

    bash
    sudo apt-get updatesudo apt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sudo shsudo usermod -aG docker $USER

    グループの変更を反映するためにログアウトしてから、再度 SSH 接続します。

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

    確認します。

    bash
    docker --versiondocker compose version

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

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

    このガイドでは、組み込んだバイナリが再起動後も維持されるように、カスタムイメージをビルドします。

  • 永続化するホストディレクトリを作成する

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

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

  • 環境変数を設定する

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

    bash
    OPENCLAW_IMAGE=openclaw:latestOPENCLAW_GATEWAY_TOKEN=OPENCLAW_GATEWAY_BIND=lanOPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/home/$USER/.openclawOPENCLAW_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 用のキーリングパスワードを生成します。

    bash
    openssl rand -hex 32

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

  • Docker Compose を設定する

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

    yaml
    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:      # 推奨：VM 上では Gateway をループバックのみに維持し、SSH トンネル経由でアクセスします。      # 公開するには、`127.0.0.1:` プレフィックスを削除し、それに応じてファイアウォールを設定します。      - "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 固有の起動時の注意事項

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

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

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

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

  • ノートパソコンからアクセスする

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

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

    ブラウザーで http://127.0.0.1:18789/ を開きます。

    余分な情報を含まないダッシュボードリンクを再表示します。

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

    UI で共有シークレット認証を求められた場合は、設定したトークンまたはパスワードを Control UI の設定に貼り付けます（この Docker 手順ではデフォルトでトークンが書き込まれます。パスワード認証に切り替えた場合は、設定したパスワードを使用してください）。

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

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

    共通の永続化マップについては Docker VM ランタイム、更新手順も参照してください。

    • トラブルシューティング

    SSH 接続が拒否される

    VM の作成後、SSH 鍵の反映には 1～2 分かかることがあります。待ってから再試行してください。

    OS Login の問題

    OS Login プロファイルを確認します。

    bash
    gcloud compute os-login describe-profile

    アカウントに必要な IAM 権限（Compute OS Login または Compute OS Admin Login）があることを確認してください。

    メモリ不足（OOM）

    Docker ビルドが Killed と exit code 137 で失敗した場合、VM は OOM によって強制終了されています。

    bash
    # 最初に VM を停止するgcloud compute instances stop openclaw-gateway --zone=us-central1-a # マシンタイプを変更するgcloud compute instances set-machine-type openclaw-gateway \  --zone=us-central1-a \  --machine-type=e2-small # VM を起動するgcloud compute instances start openclaw-gateway --zone=us-central1-a

    サービスアカウント（セキュリティのベストプラクティス）

    個人利用では、デフォルトのユーザーアカウントで問題ありません。自動化や CI/CD では、最小限の権限を持つ専用サービスアカウントを作成します。

    bash
    gcloud iam service-accounts create openclaw-deploy \  --display-name="OpenClaw Deployment" gcloud projects add-iam-policy-binding my-openclaw-project \  --member="serviceAccount:openclaw-deploy@my-openclaw-project.iam.gserviceaccount.com" \  --role="roles/compute.instanceAdmin.v1"

    自動化には Owner ロールを使用せず、動作に必要な最小限のロールを使用してください。ロールについてを参照してください。

    次のステップ

    • メッセージングチャネルを設定する：チャネル
    • ローカルデバイスを Node としてペアリングする：Node
    • Gateway を設定する：Gateway の設定

    関連項目

    Was this useful?
    On this page

    On this page