Cómo ejecutar OpenClaw.app con un Remote Gateway

Conectar herramientas locales a servidores remotos suele ser un dolor de cabeza por culpa de las restricciones de red y los firewalls. Si estás buscando una forma estable de comunicar tu entorno con un Gateway externo, configurar un túnel SSH es la opción más limpia y profesional que puedes elegir.

Esta técnica te permite trabajar de forma segura sin exponer puertos innecesarios a internet. A continuación, te explico cómo configurar OpenClaw.app para que funcione perfectamente con un Gateway remoto.

Este contenido se ha fusionado en Remote Access. Consulta esa página para ver la guía actualizada.

Running OpenClaw.app with a Remote Gateway

OpenClaw.app utiliza túneles SSH para conectarse a un Gateway remoto. Esta guía te muestra cómo configurarlo.

Resumen

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

Configuración rápida

Paso 1: Añadir configuración SSH

Edita ~/.ssh/config y añade:

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

Sustituye <REMOTE_IP> y <REMOTE_USER> con tus valores.

Paso 2: Copiar la clave SSH

Copia tu clave pública a la máquina remota (introduce la contraseña una vez):

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

Paso 3: Configurar el token del Gateway

launchctl setenv OPENCLAW_GATEWAY_TOKEN "<your-token>"

Paso 4: Iniciar el túnel SSH

ssh -N remote-gateway &

Paso 5: Reiniciar OpenClaw.app

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

La app ahora se conectará al Gateway remoto a través del túnel SSH.

---

Inicio automático del túnel al iniciar sesión

<?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>

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

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

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

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