GCP

Install gcloud CLI (or use Console)

ติดตั้งจาก cloud.google.com/sdk/docs/install จากนั้นเรียกใช้:

gcloud initgcloud auth login

หรือดำเนินการทุกขั้นตอนด้านล่างผ่านเว็บ UI ของ Cloud Console แทน

Create a GCP project

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

Create the 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

SSH into the VM

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

ใน Console: คลิก "SSH" ถัดจาก VM ในแดชบอร์ด Compute Engine

การเผยแพร่คีย์ SSH อาจใช้เวลา 1-2 นาทีหลังสร้าง VM หากการเชื่อมต่อถูกปฏิเสธ ให้รอแล้วลองใหม่

Install Docker (on the 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

Clone the OpenClaw repository

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

คู่มือนี้สร้างอิมเมจแบบกำหนดเอง เพื่อให้ไบนารีที่คุณฝังไว้ยังคงอยู่หลังการรีสตาร์ต

Create persistent host directories

คอนเทนเนอร์ Docker มีลักษณะชั่วคราว ดังนั้นสถานะระยะยาวทั้งหมดต้องจัดเก็บไว้บนโฮสต์

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

Configure environment variables

สร้าง .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

กำหนด OPENCLAW_GATEWAY_TOKEN เพื่อจัดการโทเค็น Gateway แบบคงที่ผ่าน .env มิฉะนั้น ให้กำหนดค่า 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 configuration

สร้างหรืออัปเดต 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 หรือรหัสผ่าน) และโหมดการผูกที่ปลอดภัยสำหรับการปรับใช้งานของคุณ

Shared Docker VM runtime steps

ปฏิบัติตามคู่มือรันไทม์ที่ใช้ร่วมกันสำหรับขั้นตอนทั่วไปของโฮสต์ Docker:

• ฝังไบนารีที่จำเป็นลงในอิมเมจ
• สร้างและเริ่มทำงาน
• สิ่งใดคงอยู่ที่ตำแหน่งใด
• การอัปเดต

GCP-specific launch notes

หากการสร้างล้มเหลวโดยแสดง Killed หรือ exit code 137 ระหว่าง pnpm install --frozen-lockfile แสดงว่า 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 ด้วยพอร์ตที่กำหนดไว้

Access from your laptop

สร้างอุโมงค์ SSH เพื่อส่งต่อพอร์ตของ Gateway:

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 ขอการยืนยันตัวตนด้วยข้อมูลลับที่ใช้ร่วมกัน ให้วางโทเค็นหรือ รหัสผ่านที่กำหนดค่าไว้ในการตั้งค่า UI ควบคุม (ขั้นตอน Docker นี้จะเขียนโทเค็น โดยค่าเริ่มต้น หากคุณเปลี่ยนเป็นการยืนยันตัวตนด้วยรหัสผ่าน ให้ใช้รหัสผ่าน ที่กำหนดไว้แทน)

หาก UI ควบคุมแสดง unauthorized หรือ disconnected (1008): pairing required ให้อนุมัติอุปกรณ์เบราว์เซอร์:

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

โปรดดูแผนผังการจัดเก็บถาวรที่ใช้ร่วมกันใน รันไทม์ VM ของ Docker และดู ขั้นตอนการอัปเดต