GCP

Instal CLI gcloud (atau gunakan Console)

Instal dari cloud.google.com/sdk/docs/install, lalu:

gcloud initgcloud auth login

Atau lakukan semua langkah di bawah melalui antarmuka web Cloud Console.

Buat proyek GCP

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

Aktifkan penagihan di console.cloud.google.com/billing (diperlukan untuk Compute Engine).

Padanan di Console: IAM & Admin > Create Project, aktifkan penagihan, lalu APIs & Services > Enable APIs > "Compute Engine API" > Enable.

Buat 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

Masuk ke VM melalui SSH

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

Console: klik "SSH" di samping VM pada dasbor Compute Engine.

Penyebaran kunci SSH dapat memerlukan waktu 1–2 menit setelah VM dibuat; tunggu dan coba lagi jika koneksi ditolak.

Instal Docker (pada VM)

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

Keluar lalu masuk kembali agar perubahan grup diterapkan, kemudian masuk lagi melalui SSH:

exit

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

Verifikasi:

docker --versiondocker compose version

Klon repositori OpenClaw

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

Panduan ini membuat image khusus agar semua biner yang Anda sematkan tetap tersedia setelah mulai ulang.

Buat direktori hos persisten

Kontainer Docker bersifat sementara; semua status berumur panjang harus disimpan pada hos.

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

Konfigurasikan variabel lingkungan

Buat .env di root repositori:

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

Tetapkan OPENCLAW_GATEWAY_TOKEN untuk mengelola token Gateway yang stabil melalui .env; jika tidak, konfigurasikan gateway.auth.token sebelum mengandalkan klien setelah mulai ulang. Jika keduanya tidak ditetapkan, OpenClaw menggunakan token khusus waktu proses untuk proses mulai tersebut. Buat kata sandi keyring untuk GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Jangan commit berkas ini. Berkas ini menyimpan lingkungan kontainer/waktu proses seperti OPENCLAW_GATEWAY_TOKEN. Autentikasi OAuth/kunci API penyedia yang disimpan berada dalam ~/.openclaw/agents/<agentId>/agent/auth-profiles.json yang dipasang.

Konfigurasi Docker Compose

Buat atau perbarui 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:      # Disarankan: pertahankan Gateway hanya pada loopback di VM; akses melalui terowongan SSH.      # Untuk memaparkannya secara publik, hapus prefiks `127.0.0.1:` dan konfigurasikan firewall sebagaimana mestinya.      - "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 hanya untuk memudahkan proses bootstrap, bukan pengganti konfigurasi Gateway yang sebenarnya. Tetap atur autentikasi (gateway.auth.token atau kata sandi) dan mode pengikatan yang aman untuk penerapan Anda.

Langkah waktu proses VM Docker bersama

Ikuti panduan waktu proses bersama untuk alur hos Docker umum:

• Sematkan biner yang diperlukan ke dalam image
• Lakukan build dan jalankan
• Yang dipertahankan dan lokasinya
• Pembaruan

Catatan peluncuran khusus GCP

Jika build gagal dengan Killed atau exit code 137 saat menjalankan pnpm install --frozen-lockfile, VM kehabisan memori. Gunakan setidaknya e2-small, atau e2-medium agar build pertama lebih andal.

Saat mengikat ke LAN (OPENCLAW_GATEWAY_BIND=lan), konfigurasikan asal peramban tepercaya sebelum melanjutkan:

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

Ganti 18789 dengan porta yang Anda konfigurasikan jika Anda mengubahnya.

Akses dari laptop Anda

Buat terowongan SSH untuk meneruskan porta Gateway:

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

Buka http://127.0.0.1:18789/ di peramban Anda.

Tampilkan kembali tautan dasbor yang bersih:

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

Jika antarmuka meminta autentikasi rahasia bersama, tempel token atau kata sandi yang dikonfigurasikan ke pengaturan Control UI (alur Docker ini menulis token secara default; gunakan kata sandi yang Anda konfigurasikan jika Anda beralih ke autentikasi kata sandi).

Jika Control UI menampilkan unauthorized atau disconnected (1008): pairing required, setujui perangkat peramban:

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

Lihat Waktu Proses VM Docker untuk peta persistensi bersama dan alur pembaruan.