GCP

Führen Sie ein dauerhaftes OpenClaw Gateway auf einer GCP-Compute-Engine-VM mit Docker aus – mit persistentem Zustand, fest integrierten Binärdateien und sicherem Neustartverhalten. Die Preise variieren je nach Maschinentyp und Region. Wählen Sie die kleinste VM, die für Ihre Arbeitslast ausreicht, und skalieren Sie sie hoch, wenn Speicherüberschreitungen auftreten. Auf das Gateway kann über eine SSH-Portweiterleitung von Ihrem Laptop aus zugegriffen werden. Alternativ können Sie den Port direkt freigeben, wenn Sie Firewall und Tokens selbst verwalten. Diese Anleitung verwendet Debian auf GCP Compute Engine. Ubuntu funktioniert ebenfalls; passen Sie die Pakete entsprechend an. Den allgemeinen Docker-Ablauf finden Sie unter Docker.

Voraussetzungen

GCP-Konto (e2-micro ist für das kostenlose Kontingent qualifiziert)
gcloud CLI oder die Cloud Console
SSH-Zugriff von Ihrem Laptop
Docker und Docker Compose
Anmeldedaten für das Modell
Optionale Provider-Anmeldedaten (WhatsApp-QR-Code, Telegram-Bot-Token, Gmail-OAuth)
ca. 20–30 Minuten

Schnellverfahren

GCP-Projekt erstellen, Abrechnung und Compute Engine API aktivieren
Compute-Engine-VM erstellen (e2-small, Debian 12, 20GB)
Per SSH mit der VM verbinden und Docker installieren
OpenClaw-Repository klonen
Persistente Hostverzeichnisse erstellen
.env und docker-compose.yml konfigurieren
Erforderliche Binärdateien fest integrieren, erstellen und starten

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 init
gcloud 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-project
gcloud 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

Typ	Spezifikationen	Kosten	Hinweise
e2-medium	2 vCPU, 4GB RAM	ca. $25/Monat	Am zuverlässigsten für lokale Docker-Builds
e2-small	2 vCPU, 2GB RAM	ca. $12/Monat	Empfohlenes Minimum für einen Docker-Build
e2-micro	2 vCPU (geteilt), 1GB RAM	Für kostenloses Kontingent qualifiziert	Scheitert häufig wegen Speichermangels beim Docker-Build (Exit 137)

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 update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh
sudo 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 --version
docker compose version

OpenClaw-Repository klonen

git clone https://github.com/openclaw/openclaw.git
cd 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 ~/.openclaw
mkdir -p ~/.openclaw/workspace

Umgebungsvariablen konfigurieren

Erstellen Sie .env im Stammverzeichnis des Repositorys:

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

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:

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 list
docker compose run --rm openclaw-cli devices approve <requestId>

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

Fehlerbehebung

SSH-Verbindung abgelehnt Die Übertragung des SSH-Schlüssels kann nach dem Erstellen der VM 1–2 Minuten dauern. Warten Sie und versuchen Sie es erneut. Probleme mit OS Login Überprüfen Sie Ihr OS-Login-Profil:

gcloud compute os-login describe-profile

Stellen Sie sicher, dass Ihr Konto über die erforderlichen IAM-Berechtigungen verfügt (Compute OS Login oder Compute OS Admin Login). Nicht genügend Arbeitsspeicher (OOM) Wenn der Docker-Build mit Killed und exit code 137 fehlschlägt, wurde die VM wegen Speichermangels beendet:

# Zuerst die VM anhalten
gcloud compute instances stop openclaw-gateway --zone=us-central1-a

# Maschinentyp ändern
gcloud compute instances set-machine-type openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small

# VM starten
gcloud compute instances start openclaw-gateway --zone=us-central1-a

Dienstkonten (bewährte Sicherheitspraktiken)

Für die persönliche Nutzung ist Ihr standardmäßiges Benutzerkonto ausreichend. Erstellen Sie für Automatisierung oder CI/CD ein dediziertes Dienstkonto mit minimalen Berechtigungen:

gcloud iam service-accounts create openclaw-deploy \
  --display-name="OpenClaw Deployment"

gcloud projects add-iam-policy-binding my-openclaw-project \
  --member="serviceAccount:openclaw-deploy@my-openclaw-project.iam.gserviceaccount.com" \
  --role="roles/compute.instanceAdmin.v1"

Vermeiden Sie für die Automatisierung die Rolle Owner. Verwenden Sie die Rolle mit den geringstmöglichen Berechtigungen, die noch funktioniert. Weitere Informationen finden Sie unter Rollen verstehen.

Nächste Schritte

Messaging-Kanäle einrichten: Kanäle
Lokale Geräte als Nodes koppeln: Nodes
Gateway konfigurieren: Gateway-Konfiguration

Install overview

Maintenance

Containers

Hosting

Advanced setup

Voraussetzungen

Schnellverfahren

Fehlerbehebung

Dienstkonten (bewährte Sicherheitspraktiken)

Nächste Schritte

Verwandte Themen

​Voraussetzungen

​Schnellverfahren

​Fehlerbehebung

​Dienstkonten (bewährte Sicherheitspraktiken)

​Nächste Schritte

​Verwandte Themen

Voraussetzungen

Schnellverfahren

Fehlerbehebung

Dienstkonten (bewährte Sicherheitspraktiken)

Nächste Schritte

Verwandte Themen