Zum Hauptinhalt springen
EasyRunner kann das OpenClaw Gateway als kleine containerisierte App hinter seinem Caddy-Proxy hosten. Diese Anleitung setzt einen EasyRunner-Host voraus, der Podman-kompatible Compose-Apps ausführt und HTTPS über Caddy bereitstellt.

​
Bevor Sie beginnen

  • Ein EasyRunner-Server mit einer darauf gerouteten Domain.
  • Ein gebautes oder veröffentlichtes OpenClaw-Container-Image.
  • Ein persistentes Konfigurations-Volume für /home/node/.openclaw.
  • Ein persistentes Workspace-Volume für /workspace.
  • Ein starkes Gateway-Token oder Passwort.
Lassen Sie die Geräteauthentifizierung nach Möglichkeit aktiviert. Wenn Ihre Reverse-Proxy-Bereitstellung die Geräteidentität nicht korrekt weitergeben kann, beheben Sie zuerst die Trusted-Proxy-Einstellungen; verwenden Sie gefährliche Authentifizierungs-Bypässe nur für ein vollständig privates, vom Betreiber kontrolliertes Netzwerk.

​
Compose-App

Erstellen Sie eine EasyRunner-App mit einer Compose-Datei in dieser Form: 
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    environment:
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_HOME: /home/node
      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_WORKSPACE_DIR: /workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"]

volumes:
  openclaw-config:
  openclaw-workspace:
Ersetzen Sie openclaw.example.com durch Ihren Gateway-Hostnamen. Speichern Sie OPENCLAW_GATEWAY_TOKEN im Secret-/Umgebungsmanager von EasyRunner, anstatt es in die App-Definition zu committen.

​
OpenClaw konfigurieren

Halten Sie das Gateway innerhalb des persistenten Konfigurations-Volumes nur über den Proxy erreichbar und verlangen Sie Authentifizierung: 
{
  gateway: {
    bind: "lan",
    port: 1455,
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}
Wenn Caddy TLS für das Gateway terminiert, konfigurieren Sie Trusted-Proxy-Einstellungen für den genauen Proxy-Pfad, anstatt Authentifizierungsprüfungen global zu deaktivieren. Siehe Trusted-Proxy-Authentifizierung.

​
Überprüfen

Von Ihrer Workstation aus: 
openclaw gateway probe --url https://openclaw.example.com --token <token>
openclaw gateway status --url https://openclaw.example.com --token <token>
Prüfen Sie auf dem EasyRunner-Host die App-Logs auf ein lauschendes Gateway und keine Startfehler bei SecretRef-, Plugin- oder Kanal-Authentifizierung.

​
Updates und Backups

  • Ziehen oder bauen Sie das neue OpenClaw-Image und stellen Sie anschließend die EasyRunner-App erneut bereit.
  • Sichern Sie das Volume openclaw-config vor Updates.
  • Sichern Sie openclaw-workspace, wenn Agenten dort dauerhafte Projektdaten schreiben.
  • Führen Sie openclaw doctor nach größeren Updates aus, um Konfigurationsmigrationen und Dienstwarnungen zu erkennen.

​
Fehlerbehebung

  • gateway probe kann keine Verbindung herstellen: Bestätigen Sie, dass der Caddy-Hostname auf die App zeigt und dass der Container auf 0.0.0.0:1455 lauscht.
  • Authentifizierung schlägt fehl: Rotieren Sie das Token in EasyRunner-Secrets und im lokalen Client-Befehl gemeinsam.
  • Dateien gehören nach der Wiederherstellung root: Reparieren Sie die eingebundenen Volumes, damit der Container-Benutzer in /home/node/.openclaw und /workspace schreiben kann.
  • Browser- oder Kanal-Plugins schlagen fehl: Prüfen Sie, ob die erforderlichen externen Binärdateien, der Netzwerk-Egress und eingebundene Anmeldedaten innerhalb des Containers verfügbar sind.