GCP

Installeer de gcloud CLI (of gebruik Console)

Installeer deze via cloud.google.com/sdk/docs/install en voer vervolgens het volgende uit:

gcloud initgcloud auth login

Je kunt in plaats daarvan ook alle onderstaande stappen uitvoeren via de webinterface van de Cloud Console.

Maak een GCP-project

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

Schakel facturering in via console.cloud.google.com/billing (vereist voor Compute Engine).

Overeenkomstige stappen in Console: IAM & Admin > Create Project, schakel facturering in en ga vervolgens naar APIs & Services > Enable APIs > "Compute Engine API" > Enable.

Maak de 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

Maak via SSH verbinding met de VM

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

Console: klik naast de VM in het Compute Engine-dashboard op "SSH".

Het doorgeven van SSH-sleutels kan na het maken van de VM 1-2 minuten duren; wacht en probeer het opnieuw als de verbinding wordt geweigerd.

Installeer Docker (op de VM)

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

Meld je af en weer aan om de groepswijziging toe te passen en maak daarna opnieuw via SSH verbinding:

exit

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

Controleer:

docker --versiondocker compose version

Kloon de OpenClaw-repository

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

Deze handleiding bouwt een aangepaste image, zodat alle ingebouwde binaire bestanden behouden blijven na herstarts.

Maak permanente hostmappen

Docker-containers zijn tijdelijk; alle lang bewaarde status moet op de host staan.

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

Configureer omgevingsvariabelen

Maak .env in de hoofdmap van de repository:

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

Stel OPENCLAW_GATEWAY_TOKEN in om het stabiele Gateway-token te beheren via .env; configureer anders gateway.auth.token voordat je erop vertrouwt dat clients na herstarts verbonden kunnen worden. Als geen van beide is ingesteld, gebruikt OpenClaw voor die opstart een token dat alleen tijdens runtime bestaat. Genereer een sleutelringwachtwoord voor GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Commit dit bestand niet. Het bevat omgevingsvariabelen voor de container/runtime, zoals OPENCLAW_GATEWAY_TOKEN. Opgeslagen OAuth-/API-sleutelauthenticatie voor providers staat in de aangekoppelde ~/.openclaw/agents/<agentId>/agent/auth-profiles.json.

Docker Compose-configuratie

Maak of werk docker-compose.yml bij:

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:      # Aanbevolen: houd de Gateway op de VM beperkt tot de loopback-interface; gebruik een SSH-tunnel voor toegang.      # Verwijder het voorvoegsel `127.0.0.1:` en pas de firewall dienovereenkomstig aan om deze openbaar toegankelijk te maken.      - "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 is uitsluitend bedoeld voor gemak tijdens het opstarten en is geen vervanging voor een echte Gateway-configuratie. Stel nog steeds authenticatie (gateway.auth.token of een wachtwoord) en een veilige bindmodus voor je implementatie in.

Gedeelde runtimestappen voor Docker-VM's

Volg de gedeelde runtimehandleiding voor de algemene Docker-hostprocedure:

• Bouw de vereiste binaire bestanden in de image in
• Bouw en start
• Wat waar permanent wordt opgeslagen
• Updates

GCP-specifieke opmerkingen voor het starten

Als de build tijdens pnpm install --frozen-lockfile mislukt met Killed of exit code 137, heeft de VM onvoldoende geheugen. Gebruik minimaal e2-small, of e2-medium voor betrouwbaardere eerste builds.

Als je aan LAN bindt (OPENCLAW_GATEWAY_BIND=lan), configureer je een vertrouwde browseroorsprong voordat je doorgaat:

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

Vervang 18789 door je geconfigureerde poort als je deze hebt gewijzigd.

Toegang vanaf je laptop

Maak een SSH-tunnel om de Gateway-poort door te sturen:

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

Open http://127.0.0.1:18789/ in je browser.

Geef opnieuw een schone dashboardlink weer:

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

Als de UI om authenticatie met een gedeeld geheim vraagt, plak je het geconfigureerde token of wachtwoord in de instellingen van de Control UI (deze Docker-procedure schrijft standaard een token; gebruik in plaats daarvan je geconfigureerde wachtwoord als je bent overgeschakeld op wachtwoordauthenticatie).

Als de Control UI unauthorized of disconnected (1008): pairing required toont, keur je het browserapparaat goed:

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

Zie Docker-VM-runtime voor het gedeelde overzicht van permanente opslag en de updateprocedure.