Configuración de puerta de enlace remota

Este contenido se ha fusionado en Acceso remoto. Consulte esa página para obtener la guía actual.

Ejecutar OpenClaw.app con una puerta de enlace remota

OpenClaw.app utiliza túneles SSH para conectarse a una puerta de enlace remota. Esta guía le 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: Agregar configuración SSH

Edite ~/.ssh/config y agregue:

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

Reemplace <REMOTE_IP> y <REMOTE_USER> con sus valores.

Paso 2: Copiar clave SSH

Copie su clave pública en la máquina remota (ingrese la contraseña una vez):

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

Paso 3: Configurar la autenticación de la puerta de enlace remota

openclaw config set gateway.remote.token "<your-token>"

Use gateway.remote.password en su lugar si su puerta de enlace remota usa autenticación por contraseña. OPENCLAW_GATEWAY_TOKEN sigue siendo válido como una anulación a nivel de shell, pero la configuración durable del cliente remoto es gateway.remote.token / gateway.remote.password.

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 aplicación ahora se conectará a la puerta de enlace remota a través del túnel SSH.

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

Para que el túnel SSH se inicie automáticamente cuando inicie sesión, cree un Launch Agent.

Crear el archivo PLIST

Guarde esto como ~/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>

Cargar el Launch Agent

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

El túnel ahora:

Se iniciará automáticamente cuando inicie sesión
Se reiniciará si falla
Se mantendrá ejecutándose en segundo plano

Nota heredada: elimine cualquier LaunchAgent com.openclaw.ssh-tunnel restante si está presente.

Solución de problemas

Comprobar si el túnel se está ejecutando:

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

Reiniciar el túnel:

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

Detener el túnel:

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

Cómo funciona

Componente	Lo que hace
`LocalForward 18789 127.0.0.1:18789`	Reenvía el puerto local 18789 al puerto remoto 18789
`ssh -N`	SSH sin ejecutar comandos remotos (solo reenvío de puerto)
`KeepAlive`	Reinicia automáticamente el túnel si falla
`RunAtLoad`	Inicia el túnel cuando se carga el agente

OpenClaw.app se conecta a ws://127.0.0.1:18789 en su máquina cliente. El túnel SSH reenvía esa conexión al puerto 18789 en la máquina remota donde se está ejecutando la puerta de enlace.