GCP

gcloud CLI installeren (of Console gebruiken)

Optie A: gcloud CLI (aanbevolen voor automatisering)

Installeer vanaf https://cloud.google.com/sdk/docs/install

Initialiseer en authenticeer:

gcloud init
gcloud auth login

Optie B: Cloud Console

Alle stappen kunnen via de web-UI op https://console.cloud.google.com worden uitgevoerd

Een GCP-project maken

CLI:

gcloud projects create my-openclaw-project --name="OpenClaw Gateway"
gcloud config set project my-openclaw-project

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

Schakel de Compute Engine API in:

gcloud services enable compute.googleapis.com

Console:

1. Ga naar IAM & Admin > Create Project
2. Geef het een naam en maak het aan
3. Schakel facturering in voor het project
4. Navigeer naar APIs & Services > Enable APIs > zoek "Compute Engine API" > Enable

De VM maken

Machinetypen:

CLI:

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

Console:

1. Ga naar Compute Engine > VM instances > Create instance
2. Naam: openclaw-gateway
3. Regio: us-central1, Zone: us-central1-a
4. Machinetype: e2-small
5. Opstartschijf: Debian 12, 20GB
6. Maak aan

Via SSH verbinden met de VM

CLI:

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

Console:

Klik op de knop "SSH" naast je VM in het Compute Engine-dashboard.

Opmerking: verspreiding van SSH-sleutels kan na het maken van de VM 1-2 minuten duren. Als de verbinding wordt geweigerd, wacht dan en probeer opnieuw.

Docker installeren (op de VM)

sudo apt-get update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

Log uit en opnieuw in zodat de groepswijziging van kracht wordt:

exit

Verbind daarna opnieuw via SSH:

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

Controleer:

docker --version
docker compose version

De OpenClaw-repository klonen

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

Deze gids gaat ervan uit dat je een aangepaste image bouwt om binaire persistentie te garanderen.

Permanente hostmappen maken

Docker-containers zijn vluchtig. Alle langlevende status moet op de host staan.

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

Omgevingsvariabelen configureren

Maak .env in de repositoryroot.

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/home/$USER/.openclaw
OPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace

GOG_KEYRING_PASSWORD=
XDG_CONFIG_HOME=/home/node/.openclaw

Stel OPENCLAW_GATEWAY_TOKEN in wanneer je het stabiele Gateway-token via .env wilt beheren; configureer anders gateway.auth.token voordat je op clients over herstarts heen vertrouwt. Als geen van beide bronnen bestaat, gebruikt OpenClaw een runtime-only token voor die start. Genereer een keyringwachtwoord en plak het in GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Commit dit bestand niet.

Dit .env-bestand is bedoeld voor container-/runtime-env zoals OPENCLAW_GATEWAY_TOKEN. Opgeslagen provider-OAuth/API-key-authenticatie staat in het gekoppelde ~/.openclaw/agents/<agentId>/agent/auth-profiles.json.

Docker Compose-configuratie

Maak of update 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 is alleen bedoeld voor gemakkelijk bootstrappen; het is geen vervanging voor een juiste Gateway-configuratie. Stel nog steeds auth in (gateway.auth.token of wachtwoord) en gebruik veilige bindinstellingen voor je deployment.

Gedeelde Docker-VM-runtimestappen

Gebruik de gedeelde runtimegids voor de algemene Docker-hostflow:

• Vereiste binaries in de image bakken
• Bouwen en starten
• Wat waar persistent blijft
• Updates

GCP-specifieke startnotities

Als de build op GCP 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.

Configureer bij binden aan LAN (OPENCLAW_GATEWAY_BIND=lan) een vertrouwde browser-origin voordat je doorgaat:

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

Als je de Gateway-poort hebt gewijzigd, vervang dan 18789 door je geconfigureerde poort.

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 in je browser:

http://127.0.0.1:18789/

Druk opnieuw een schone dashboardlink af:

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

Als de UI om shared-secret-authenticatie vraagt, plak dan het geconfigureerde token of wachtwoord in de Control UI-instellingen. Deze Docker-flow schrijft standaard een token; als je de containerconfiguratie overschakelt naar wachtwoordauthenticatie, gebruik dan in plaats daarvan dat wachtwoord.

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

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

Heb je de gedeelde referentie voor persistentie en updates opnieuw nodig? Zie Docker VM Runtime en Docker VM Runtime-updates.