GCP

gcloud CLI इंस्टॉल करें (या Console का उपयोग करें)

cloud.google.com/sdk/docs/install से इंस्टॉल करें, फिर:

gcloud initgcloud auth login

या इसके बजाय नीचे दिए गए प्रत्येक चरण को Cloud Console वेब UI के माध्यम से पूरा करें।

एक GCP प्रोजेक्ट बनाएँ

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 बनाएँ

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 करें

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

Console: Compute Engine डैशबोर्ड में VM के पास "SSH" पर क्लिक करें।

VM बनने के बाद SSH कुंजी के प्रसार में 1-2 मिनट लग सकते हैं; कनेक्शन अस्वीकार होने पर प्रतीक्षा करें और पुनः प्रयास करें।

Docker इंस्टॉल करें (VM पर)

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

समूह परिवर्तन लागू करने के लिए लॉग आउट करके फिर से लॉग इन करें, उसके बाद दोबारा SSH करें:

exit

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

सत्यापित करें:

docker --versiondocker compose version

OpenClaw रिपॉज़िटरी क्लोन करें

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

यह गाइड एक कस्टम इमेज बनाती है, ताकि आपके द्वारा उसमें शामिल की गई सभी बाइनरी रीस्टार्ट के बाद भी बनी रहें।

स्थायी होस्ट डायरेक्टरी बनाएँ

Docker कंटेनर अस्थायी होते हैं; लंबे समय तक बने रहने वाला पूरा स्टेट होस्ट पर होना चाहिए।

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

एनवायरनमेंट वेरिएबल कॉन्फ़िगर करें

रिपॉज़िटरी रूट में .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

स्थायी Gateway टोकन को .env के माध्यम से प्रबंधित करने के लिए OPENCLAW_GATEWAY_TOKEN सेट करें; अन्यथा रीस्टार्ट के बाद क्लाइंट पर निर्भर होने से पहले gateway.auth.token कॉन्फ़िगर करें। यदि दोनों में से कोई सेट नहीं है, तो OpenClaw उस स्टार्टअप के लिए केवल रनटाइम टोकन का उपयोग करता है। GOG_KEYRING_PASSWORD के लिए एक कीरिंग पासवर्ड बनाएँ:

openssl rand -hex 32

इस फ़ाइल को कमिट न करें। इसमें 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:      # अनुशंसित: 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) से बाइंड करते समय, आगे बढ़ने से पहले कोई विश्वसनीय ब्राउज़र ओरिजिन कॉन्फ़िगर करें:

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

यदि आपने पोर्ट बदला है, तो 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 listdocker compose run --rm openclaw-cli devices approve <requestId>

साझा स्थायित्व मैप के लिए Docker VM रनटाइम और अपडेट प्रवाह देखें।