GCP

gcloud CLI installieren (oder Console verwenden)

Installieren Sie sie über cloud.google.com/sdk/docs/install und führen Sie anschließend Folgendes aus:

gcloud initgcloud auth login

Alternativ können Sie alle nachfolgenden Schritte über die Weboberfläche der Cloud Console ausführen.

GCP-Projekt erstellen

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

Aktivieren Sie die Abrechnung unter console.cloud.google.com/billing (für Compute Engine erforderlich).

Entsprechender Ablauf in der Console: IAM & Admin > Create Project, Abrechnung aktivieren, dann APIs & Services > Enable APIs > "Compute Engine API" > Enable.

VM erstellen

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

Per SSH mit der VM verbinden

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

Console: Klicken Sie im Compute-Engine-Dashboard neben der VM auf "SSH".

Die Übertragung des SSH-Schlüssels kann nach dem Erstellen der VM 1–2 Minuten dauern. Warten Sie und versuchen Sie es erneut, wenn die Verbindung abgelehnt wird.

Docker installieren (auf der VM)

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

Melden Sie sich ab und wieder an, damit die Gruppenänderung wirksam wird, und stellen Sie anschließend erneut eine SSH-Verbindung her:

exit

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

Überprüfen Sie die Installation:

docker --versiondocker compose version

OpenClaw-Repository klonen

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

Diese Anleitung erstellt ein benutzerdefiniertes Image, damit alle darin fest integrierten Binärdateien Neustarts überstehen.

Persistente Hostverzeichnisse erstellen

Docker-Container sind flüchtig. Der gesamte dauerhafte Zustand muss auf dem Host gespeichert werden.

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

Umgebungsvariablen konfigurieren

Erstellen Sie .env im Stammverzeichnis des Repositorys:

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

Legen Sie OPENCLAW_GATEWAY_TOKEN fest, um den stabilen Gateway-Token über .env zu verwalten. Andernfalls konfigurieren Sie gateway.auth.token, bevor Sie sich bei Neustarts auf Clients verlassen. Wenn keines von beiden festgelegt ist, verwendet OpenClaw für diesen Start einen ausschließlich zur Laufzeit gültigen Token. Generieren Sie ein Schlüsselbundpasswort für GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Übertragen Sie diese Datei nicht in das Repository. Sie enthält Container-/Laufzeit- Umgebungsvariablen wie OPENCLAW_GATEWAY_TOKEN. Gespeicherte OAuth-/API-Schlüssel- Authentifizierungsdaten der Provider befinden sich im eingebundenen ~/.openclaw/agents/<agentId>/agent/auth-profiles.json.

Docker-Compose-Konfiguration

Erstellen oder aktualisieren Sie 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:      # Empfohlen: Das Gateway auf der VM ausschließlich an Loopback binden; Zugriff über einen SSH-Tunnel.      # Um es öffentlich freizugeben, entfernen Sie das Präfix `127.0.0.1:` und konfigurieren Sie die Firewall entsprechend.      - "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 dient ausschließlich der Vereinfachung der Ersteinrichtung und ist kein Ersatz für eine echte Gateway-Konfiguration. Legen Sie für Ihre Bereitstellung dennoch eine Authentifizierung (gateway.auth.token oder Passwort) und einen sicheren Bindungsmodus fest.

Gemeinsame Laufzeitschritte für Docker-VMs

Folgen Sie für den allgemeinen Docker-Host-Ablauf der gemeinsamen Laufzeitanleitung:

• Erforderliche Binärdateien fest in das Image integrieren
• Erstellen und starten
• Was wo persistent gespeichert wird
• Aktualisierungen

GCP-spezifische Hinweise zum Start

Wenn der Build während pnpm install --frozen-lockfile mit Killed oder exit code 137 fehlschlägt, verfügt die VM nicht über genügend Arbeitsspeicher. Verwenden Sie mindestens e2-small oder für zuverlässigere erste Builds e2-medium.

Wenn Sie an das LAN binden (OPENCLAW_GATEWAY_BIND=lan), konfigurieren Sie vor dem Fortfahren einen vertrauenswürdigen Browser-Ursprung:

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

Ersetzen Sie 18789 durch den konfigurierten Port, falls Sie ihn geändert haben.

Zugriff von Ihrem Laptop

Erstellen Sie einen SSH-Tunnel zur Weiterleitung des Gateway-Ports:

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

Öffnen Sie http://127.0.0.1:18789/ in Ihrem Browser.

Geben Sie einen bereinigten Dashboard-Link erneut aus:

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

Wenn die Benutzeroberfläche zur Authentifizierung mit einem gemeinsamen Geheimnis auffordert, fügen Sie den konfigurierten Token oder das Passwort in den Control-UI-Einstellungen ein. Dieser Docker-Ablauf schreibt standardmäßig einen Token. Verwenden Sie stattdessen Ihr konfiguriertes Passwort, wenn Sie zur Passwortauthentifizierung gewechselt haben.

Wenn die Control UI unauthorized oder disconnected (1008): pairing required anzeigt, genehmigen Sie das Browsergerät:

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

Die gemeinsame Zuordnung der persistenten Daten finden Sie unter Docker-VM-Laufzeit, den Aktualisierungsablauf ebenfalls dort.