OpenClaw.app mit einem Remote Gateway verbinden

Dieser Inhalt wurde in Remote Access integriert. Aktuelle Informationen findest du auf dieser Seite.

OpenClaw.app mit einem Remote Gateway nutzen

Kennst du das Problem? Du hast ein mächtiges Tool lokal installiert, aber die eigentliche Rechenpower oder der Dienst sitzt auf einem entfernten Server. Die Verbindung sicher und stabil zu halten, ohne Ports unnötig nach außen zu öffnen, kann echt nervig sein. SSH-Tunnel sind hier die beste Lösung, um eine direkte Brücke zwischen deinem Rechner und dem Gateway zu schlagen.

OpenClaw.app nutzt SSH-Tunneling, um eine Verbindung zu einem Remote Gateway herzustellen. In diesem Guide zeige ich dir, wie du das Setup sauber konfigurierst.

Übersicht

flowchart TB
    subgraph Client["Client Machine"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(local port)"]
        T["SSH Tunnel"]

        A --> B
        B --> T
    end
    subgraph Remote["Remote Machine"]
        direction TB
        C["Gateway WebSocket"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

Schnelle Einrichtung

Schritt 1: SSH Config anpassen

Bearbeite deine ~/.ssh/config und füge diesen Block hinzu:

Host remote-gateway
    HostName <REMOTE_IP>          # e.g., 172.27.187.184
    User <REMOTE_USER>            # e.g., jefferson
    LocalForward 18789 127.0.0.1:18789
    IdentityFile ~/.ssh/id_rsa

Ersetze <REMOTE_IP> und <REMOTE_USER> durch deine eigenen Werte.

Schritt 2: SSH-Key kopieren

Kopiere deinen Public Key auf die Remote Machine (du musst das Passwort nur einmal eingeben):

ssh-copy-id -i ~/.ssh/id_rsa <REMOTE_USER>@<REMOTE_IP>

Schritt 3: Gateway Token setzen

launchctl setenv OPENCLAW_GATEWAY_TOKEN "<your-token>"

Schritt 4: SSH-Tunnel starten

ssh -N remote-gateway &

Schritt 5: OpenClaw.app neu starten

# Quit OpenClaw.app (⌘Q), then reopen:
open /path/to/OpenClaw.app

Die App verbindet sich nun über den SSH-Tunnel mit dem Remote Gateway.

---

Tunnel beim Login automatisch starten

Damit der SSH-Tunnel automatisch startet, wenn du dich einloggst, solltest du einen Launch Agent erstellen. Das ist deutlich komfortabler als den Befehl jedes Mal manuell einzugeben.

PLIST-Datei erstellen

Speichere den folgenden Inhalt unter ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>ai.openclaw.ssh-tunnel</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/ssh</string>
        <string>-N</string>
        <string>remote-gateway</string>
    </array>
    <key>KeepAlive</key>
    <true/>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

Launch Agent laden

launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist

Der Tunnel verhält sich nun wie folgt:

• Er startet automatisch beim Login und bleibt im Hintergrund aktiv.
• Bei einem Absturz wird die Verbindung sofort neu aufgebaut.

Hinweis zu Altlasten: Entferne eventuell vorhandene com.openclaw.ssh-tunnel LaunchAgents, falls diese noch existieren.

---

Fehlerbehebung

Prüfen, ob der Tunnel läuft:

ps aux | grep "ssh -N remote-gateway" | grep -v grep
lsof -i :18789

Tunnel neu starten:

launchctl kickstart -k gui/$UID/ai.openclaw.ssh-tunnel

Tunnel stoppen:

launchctl bootout gui/$UID/ai.openclaw.ssh-tunnel

---

Wie es funktioniert

Komponente	Funktion
LocalForward 18789 127.0.0.1:18789	Leitet den lokalen Port 18789 an den Remote-Port 18789 weiter
ssh -N	SSH ohne Ausführung von Remote-Befehlen (nur Port-Forwarding)
KeepAlive	Startet den Tunnel automatisch neu, falls er abbricht
RunAtLoad	Startet den Tunnel direkt beim Laden des Agents

OpenClaw.app verbindet sich mit ws://127.0.0.1:18789 auf deinem lokalen Rechner. Der SSH-Tunnel leitet diese Verbindung an Port 18789 auf der Remote Machine weiter, auf der das Gateway läuft.

Nächste Schritte

• Gateway Konfiguration
• SSH Key Management

AI Setup Assistant