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

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

Component	Wat het doet
`LocalForward 18789 127.0.0.1:18789`	Stuurt lokale poort 18789 door naar externe poort 18789
`ssh -N`	SSH zonder het uitvoeren van externe opdrachten (alleen poortdoorsturing)
`KeepAlive`	Start de tunnel automatisch opnieuw als deze crasht
`RunAtLoad`	Start de tunnel wanneer de agent wordt geladen

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.

Gateway

Externe toegang

Webinterfaces

Installatie van de Remote Gateway

OpenClaw.app uitvoeren met een Remote Gateway

Overzicht

Snelle installatie

Stap 1: SSH-configuratie toevoegen

Stap 2: SSH-sleutel kopiëren

Stap 3: Gateway-token instellen

Stap 4: SSH-tunnel starten

Stap 5: OpenClaw.app opnieuw starten

Tunnel automatisch starten bij inloggen

Het PLIST-bestand maken

De Launch Agent laden

Problemen oplossen

Hoe het werkt

​OpenClaw.app uitvoeren met een Remote Gateway

​Overzicht

​Snelle installatie

​Stap 1: SSH-configuratie toevoegen

​Stap 2: SSH-sleutel kopiëren

​Stap 3: Gateway-token instellen

​Stap 4: SSH-tunnel starten

​Stap 5: OpenClaw.app opnieuw starten

​Tunnel automatisch starten bij inloggen

​Het PLIST-bestand maken

​De Launch Agent laden

​Problemen oplossen

​Hoe het werkt

OpenClaw.app uitvoeren met een Remote Gateway

Overzicht

Snelle installatie

Stap 1: SSH-configuratie toevoegen

Stap 2: SSH-sleutel kopiëren

Stap 3: Gateway-token instellen

Stap 4: SSH-tunnel starten

Stap 5: OpenClaw.app opnieuw starten

Tunnel automatisch starten bij inloggen

Het PLIST-bestand maken

De Launch Agent laden

Problemen oplossen

Hoe het werkt