--- read_when: - GCP 上で OpenClaw を 24 時間 365 日稼働させたい場合 - 自分の VM 上で、本番環境向けの常時稼働する Gateway を運用したい場合 - 永続化、バイナリ、再起動時の動作を完全に制御したい場合 summary: 耐久性のある状態を保持し、GCP Compute Engine VM（Docker）上で OpenClaw Gateway を 24 時間 365 日稼働させる title: GCP x-i18n: generated_at: "2026-07-11T22:20:58Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 6ca46b2ee78731162261cae6ea5a26b718be6035b998fa92e4ee5c9ea2e7ae07 source_path: install/gcp.md workflow: 16 --- Docker を使用して GCP Compute Engine VM 上で永続的な OpenClaw Gateway を実行します。永続化された状態、イメージに組み込まれたバイナリ、安全な再起動動作を備えます。 料金はマシンタイプとリージョンによって異なります。ワークロードに適合する最小の VM を選び、OOM が発生した場合はスケールアップしてください。 Gateway には、ノートパソコンから SSH ポートフォワーディング経由でアクセスできます。また、ファイアウォールとトークンを自身で管理する場合は、ポートを直接公開してアクセスすることもできます。 このガイドでは GCP Compute Engine 上の Debian を使用します。Ubuntu も使用できますが、パッケージは適宜読み替えてください。汎用的な Docker の手順については、[Docker](/ja-JP/install/docker)を参照してください。 ## 必要なもの - GCP アカウント（`e2-micro` は無料枠の対象） - `gcloud` CLI、または [Cloud Console](https://console.cloud.google.com) - ノートパソコンからの 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. 必要なバイナリをイメージに組み込み、ビルドして起動する [cloud.google.com/sdk/docs/install](https://cloud.google.com/sdk/docs/install)からインストールし、次を実行します。 ```bash gcloud init gcloud auth login ``` または、以下のすべての手順を [Cloud Console](https://console.cloud.google.com) のウェブ UI から実行します。 ```bash gcloud projects create my-openclaw-project --name="OpenClaw Gateway" gcloud config set project my-openclaw-project gcloud services enable compute.googleapis.com ``` [console.cloud.google.com/billing](https://console.cloud.google.com/billing) で請求先設定を有効にします（Compute Engine に必要です）。 Console での同等の操作：IAM & Admin > Create Project でプロジェクトを作成して請求先設定を有効にし、次に APIs & Services > Enable APIs > "Compute Engine API" > Enable を選択します。 | タイプ | 仕様 | コスト | 備考 | | --------- | ------------------------ | ------------------ | --------------------------------------------- | | 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 ``` ```bash gcloud compute ssh openclaw-gateway --zone=us-central1-a ``` Console：Compute Engine ダッシュボードで VM の横にある "SSH" をクリックします。 VM の作成後、SSH 鍵の反映には 1～2 分かかることがあります。接続を拒否された場合は、待ってから再試行してください。 ```bash 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 ``` グループの変更を反映するためにログアウトしてから、再度 SSH 接続します。 ```bash exit ``` ```bash gcloud compute ssh openclaw-gateway --zone=us-central1-a ``` 確認します。 ```bash docker --version docker compose version ``` ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw ``` このガイドでは、組み込んだバイナリが再起動後も維持されるように、カスタムイメージをビルドします。 Docker コンテナは一時的なものです。長期間保持するすべての状態はホスト上に配置する必要があります。 ```bash mkdir -p ~/.openclaw mkdir -p ~/.openclaw/workspace ``` リポジトリのルートに `.env` を作成します。 ```bash 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` 用のキーリングパスワードを生成します。 ```bash openssl rand -hex 32 ``` **このファイルをコミットしないでください。** このファイルには、`OPENCLAW_GATEWAY_TOKEN` などのコンテナ／ランタイム環境変数が含まれます。保存されたプロバイダーの OAuth／API キー認証情報は、マウントされた `~/.openclaw/agents//agent/auth-profiles.json` に格納されます。 `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 ホスト手順については、共有ランタイムガイドに従ってください。 - [必要なバイナリをイメージに組み込む](/ja-JP/install/docker-vm-runtime#bake-required-binaries-into-the-image) - [ビルドして起動する](/ja-JP/install/docker-vm-runtime#build-and-launch) - [何がどこに永続化されるか](/ja-JP/install/docker-vm-runtime#what-persists-where) - [更新](/ja-JP/install/docker-vm-runtime#updates) `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 list docker compose run --rm openclaw-cli devices approve ``` 共通の永続化マップについては [Docker VM ランタイム](/ja-JP/install/docker-vm-runtime#what-persists-where)、[更新手順](/ja-JP/install/docker-vm-runtime#updates)も参照してください。 ## トラブルシューティング **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 ロールを使用せず、動作に必要な最小限のロールを使用してください。[ロールについて](https://cloud.google.com/iam/docs/understanding-roles)を参照してください。 ## 次のステップ - メッセージングチャネルを設定する：[チャネル](/ja-JP/channels) - ローカルデバイスを Node としてペアリングする：[Node](/ja-JP/nodes) - Gateway を設定する：[Gateway の設定](/ja-JP/gateway/configuration) ## 関連項目 - [インストールの概要](/ja-JP/install) - [Azure](/ja-JP/install/azure) - [VPS ホスティング](/ja-JP/vps)