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 folgenden 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, anschließend 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. 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

In dieser Anleitung wird ein benutzerdefiniertes Image erstellt, damit alle darin integrierten Binärdateien Neustarts überstehen.

Persistente Hostverzeichnisse erstellen

Docker-Container sind flüchtig; alle dauerhaft benötigten Zustandsdaten müssen auf dem Host gespeichert werden.

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

Umgebungsvariablen konfigurieren

Erstellen Sie im Stammverzeichnis des Repositorys eine .env-Datei:

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 das stabile Gateway-Token über .env zu verwalten. Andernfalls konfigurieren Sie gateway.auth.token, bevor Sie sich darauf verlassen, dass Clients über Neustarts hinweg funktionieren. Wenn keines von beiden festgelegt ist, verwendet OpenClaw für diesen Start ein ausschließlich zur Laufzeit gültiges Token. Erzeugen Sie ein Schlüsselbund-Passwort für GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Übertragen Sie diese Datei nicht in das Repository. Sie enthält Umgebungsvariablen für Container und Laufzeit, beispielsweise OPENCLAW_GATEWAY_TOKEN. Gespeicherte OAuth- und API-Schlüssel- Authentifizierungsdaten der Provider befinden sich in der eingebundenen Datei ~/.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: Beschränken Sie den Gateway auf der VM auf Loopback; greifen Sie über einen SSH-Tunnel darauf zu.      # Um ihn öffentlich verfügbar zu machen, entfernen Sie das Präfix `127.0.0.1:` und passen Sie die Firewall entsprechend an.      - "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 nur der bequemeren Ersteinrichtung und ersetzt keine ordnungsgemäße Gateway-Konfiguration. Legen Sie weiterhin die Authentifizierung (gateway.auth.token oder ein Passwort) sowie einen sicheren Bindungsmodus für Ihre Bereitstellung fest.

Gemeinsame Laufzeitschritte für Docker-VMs

Befolgen Sie für den allgemeinen Ablauf auf einem Docker-Host die gemeinsame Laufzeitanleitung:

• Erforderliche Binärdateien in das Image integrieren
• Erstellen und starten
• Welche Daten wo persistent gespeichert werden
• Aktualisierungen

GCP-spezifische Hinweise zum Start

Wenn der Build während pnpm install --frozen-lockfile mit Killed oder exit code 137 fehlschlägt, steht der VM nicht genügend Arbeitsspeicher zur Verfügung. Verwenden Sie mindestens e2-small oder e2-medium, um zuverlässigere erste Builds zu erhalten.

Wenn Sie die Bindung an das LAN verwenden (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 von Ihnen konfigurierten Port, falls Sie ihn geändert haben.

Zugriff von Ihrem Laptop

Erstellen Sie einen SSH-Tunnel, um den Gateway-Port weiterzuleiten:

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 das konfigurierte Token oder Passwort in die Einstellungen der Control UI ein. Dieser Docker-Ablauf schreibt standardmäßig ein 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 Übersicht zur Persistenz finden Sie unter Docker-VM-Laufzeit, den Aktualisierungsablauf ebenfalls dort.