GCP

gcloud CLI install करें (या Console का उपयोग करें)

Option A: gcloud CLI (automation के लिए recommended)

https://cloud.google.com/sdk/docs/install से install करें

Initialize और authenticate करें:

gcloud initgcloud auth login

Option B: Cloud Console

सभी steps web UI के जरिए https://console.cloud.google.com पर किए जा सकते हैं

GCP project बनाएं

CLI:

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

https://console.cloud.google.com/billing पर billing सक्षम करें (Compute Engine के लिए required).

Compute Engine API सक्षम करें:

gcloud services enable compute.googleapis.com

Console:

1. IAM & Admin > Create Project पर जाएं
2. इसे name दें और create करें
3. Project के लिए billing सक्षम करें
4. APIs & Services > Enable APIs पर जाएं > "Compute Engine API" खोजें > Enable

VM बनाएं

Machine types:

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. Name: openclaw-gateway
3. Region: us-central1, Zone: us-central1-a
4. Machine type: e2-small
5. Boot disk: Debian 12, 20GB
6. Create

VM में SSH करें

CLI:

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

Console:

Compute Engine dashboard में अपने VM के पास "SSH" button पर click करें.

Note: VM creation के बाद SSH key propagation में 1-2 मिनट लग सकते हैं. अगर connection refused हो, तो प्रतीक्षा करें और retry करें.

Docker install करें (VM पर)

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

Group change प्रभावी करने के लिए log out और वापस log in करें:

exit

फिर वापस SSH करें:

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

Verify करें:

docker --versiondocker compose version

OpenClaw repository clone करें

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

यह guide मानती है कि आप binary persistence की guarantee के लिए custom image build करेंगे.

Persistent host directories बनाएं

Docker containers ephemeral होते हैं. सारी long-lived state host पर रहनी चाहिए.

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

Environment variables configure करें

Repository root में .env बनाएं.

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

जब आप stable gateway token को .env के जरिए manage करना चाहते हैं, तो OPENCLAW_GATEWAY_TOKEN set करें; अन्यथा restarts के पार clients पर भरोसा करने से पहले gateway.auth.token configure करें. अगर कोई भी source मौजूद नहीं है, तो OpenClaw उस startup के लिए runtime-only token का उपयोग करता है. एक keyring password generate करें और उसे GOG_KEYRING_PASSWORD में paste करें:

openssl rand -hex 32

इस file को commit न करें.

यह .env file container/runtime env जैसे OPENCLAW_GATEWAY_TOKEN के लिए है. Stored provider OAuth/API-key auth mounted ~/.openclaw/agents/<agentId>/agent/auth-profiles.json में रहता है.

Docker Compose configuration

docker-compose.yml बनाएं या update करें.

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 केवल bootstrap सुविधा के लिए है, यह proper gateway configuration का replacement नहीं है. फिर भी अपने deployment के लिए auth (gateway.auth.token या password) set करें और safe bind settings का उपयोग करें.

Shared Docker VM runtime steps

Common Docker host flow के लिए shared runtime guide का उपयोग करें:

• Required binaries को image में bake करें
• Build और launch करें
• क्या कहां persist होता है
• Updates

GCP-specific launch notes

GCP पर, अगर pnpm install --frozen-lockfile के दौरान build Killed या exit code 137 के साथ fail होता है, तो VM में memory कम है. Minimum e2-small का उपयोग करें, या ज्यादा reliable first builds के लिए e2-medium का उपयोग करें.

LAN (OPENCLAW_GATEWAY_BIND=lan) से bind करते समय, आगे बढ़ने से पहले trusted browser origin configure करें:

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

अगर आपने gateway port बदला है, तो 18789 को अपने configured port से बदलें.

अपने laptop से access करें

Gateway port forward करने के लिए SSH tunnel बनाएं:

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

अपने browser में खोलें:

http://127.0.0.1:18789/

एक clean dashboard link फिर से print करें:

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

अगर UI shared-secret auth के लिए prompt करता है, तो configured token या password को Control UI settings में paste करें. यह Docker flow default रूप से token लिखता है; अगर आप container config को password auth पर switch करते हैं, तो इसके बजाय वह password उपयोग करें.

अगर Control UI unauthorized या disconnected (1008): pairing required दिखाता है, तो browser device approve करें:

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

Shared persistence और update reference फिर चाहिए? Docker VM Runtime और Docker VM Runtime updates देखें.