GCP

Installeer de gcloud CLI (of gebruik de Console)

Installeer deze via cloud.google.com/sdk/docs/install en voer vervolgens 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).

Equivalent in de 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 op "SSH" naast de VM in het Compute Engine-dashboard.

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 van kracht te laten worden 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 langlevende status moet op de host worden opgeslagen.

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 via .env te beheren; configureer anders gateway.auth.token voordat je erop vertrouwt dat clients na herstarts verbinding kunnen maken. Als geen van beide is ingesteld, gebruikt OpenClaw voor die startsessie een token dat alleen tijdens runtime bestaat. Genereer een wachtwoord voor de sleutelring 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 het gekoppelde ~/.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 alleen op loopback; gebruik een SSH-tunnel voor toegang.      # Verwijder om deze openbaar toegankelijk te maken het voorvoegsel `127.0.0.1:` en configureer de firewall dienovereenkomstig.      - "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 alleen bedoeld voor gemak tijdens de initiële configuratie en is geen vervanging voor een echte Gateway-configuratie. Stel nog steeds authenticatie (gateway.auth.token of een wachtwoord) en een veilige bindingsmodus in voor je implementatie.

Gedeelde runtimestappen voor Docker-VM's

Volg de gedeelde runtimehandleiding voor de algemene Docker-hostprocedure:

• Bouw 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 mislukt met Killed of exit code 137 tijdens pnpm install --frozen-lockfile, heeft de VM onvoldoende geheugen. Gebruik minimaal e2-small, of e2-medium voor betrouwbaardere eerste builds.

Wanneer je aan LAN bindt (OPENCLAW_GATEWAY_BIND=lan), moet je een vertrouwde browseroorsprong configureren voordat je verdergaat:

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.

Toon opnieuw een overzichtelijke dashboardlink:

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

Als de gebruikersinterface 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 weergeeft, 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.