OpenClaw.app uitvoeren met een Remote Gateway¶

OpenClaw.app gebruikt SSH-tunneling om verbinding te maken met een externe gateway. Deze gids laat zien hoe je dit instelt.

Overzicht¶

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#ffffff',
    'primaryTextColor': '#000000',
    'primaryBorderColor': '#000000',
    'lineColor': '#000000',
    'secondaryColor': '#f9f9fb',
    'tertiaryColor': '#ffffff',
    'clusterBkg': '#f9f9fb',
    'clusterBorder': '#000000',
    'nodeBorder': '#000000',
    'mainBkg': '#ffffff',
    'edgeLabelBackground': '#ffffff'
  }
}}%%
flowchart TB
    subgraph Client["Clientmachine"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(lokale poort)"]
        T["SSH-tunnel"]

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

        C --> D
    end
    T --> C

Snelle installatie¶

Stap 1: SSH-configuratie toevoegen¶

Bewerk ~/.ssh/config en voeg toe:

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

Vervang <REMOTE_IP> en <REMOTE_USER> door je eigen waarden.

Stap 2: SSH-sleutel kopiëren¶

Kopieer je publieke sleutel naar de externe machine (voer het wachtwoord één keer in):

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

Stap 3: Gateway-token instellen¶

launchctl setenv OPENCLAW_GATEWAY_TOKEN "<your-token>"

Stap 4: SSH-tunnel starten¶

ssh -N remote-gateway &

Stap 5: OpenClaw.app opnieuw starten¶

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

De app maakt nu verbinding met de externe gateway via de SSH-tunnel.

Tunnel automatisch starten bij inloggen¶

Om de SSH-tunnel automatisch te laten starten wanneer je inlogt, maak je een Launch Agent aan.

Het PLIST-bestand maken¶

Sla dit op als ~/Library/LaunchAgents/bot.molt.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>bot.molt.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>

De Launch Agent laden¶

launchctl bootstrap gui/$UID ~/Library/LaunchAgents/bot.molt.ssh-tunnel.plist

De tunnel zal nu:

• Automatisch starten wanneer je inlogt
• Opnieuw starten als deze crasht
• Op de achtergrond blijven draaien

Legacy-opmerking: verwijder eventuele overgebleven com.openclaw.ssh-tunnel LaunchAgent indien aanwezig.

Problemen oplossen¶

Controleren of de tunnel draait:

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

De tunnel herstarten:

launchctl kickstart -k gui/$UID/bot.molt.ssh-tunnel

De tunnel stoppen:

launchctl bootout gui/$UID/bot.molt.ssh-tunnel

Hoe het werkt¶

OpenClaw.app maakt verbinding met ws://127.0.0.1:18789 op je clientmachine. De SSH-tunnel stuurt die verbinding door naar poort 18789 op de externe machine waar de Gateway draait.