Ejecutar OpenClaw.app con un Gateway remoto

OpenClaw.app se conecta a un Gateway remoto mediante un túnel SSH: un LocalForward de SSH asigna un puerto local al puerto WebSocket del Gateway en el host remoto.

flowchart TB
    subgraph Client["Equipo cliente"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(puerto local)"]
        T["Túnel SSH"]

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

        C --> D
    end
    T --> C

Configuración

1. Añade una entrada de configuración de SSH con LocalForward 18789 127.0.0.1:18789 (consulta Acceso remoto para ver el bloque de configuración completo).
2. Copia tu clave SSH al host remoto con ssh-copy-id.
3. Establece gateway.remote.token (o gateway.remote.password) mediante openclaw config set gateway.remote.token "<your-token>".
4. Inicia el túnel: ssh -N remote-gateway &.
5. Cierra y vuelve a abrir OpenClaw.app.

Para disponer de un túnel que sobreviva a los reinicios y se vuelva a conectar automáticamente, utiliza la configuración de LaunchAgent de la página Acceso remoto en lugar de ejecutar manualmente ssh -N.

Cómo funciona

OpenClaw.app se conecta a ws://127.0.0.1:18789 en el cliente. El túnel reenvía esa conexión al puerto 18789 del host remoto que ejecuta el Gateway.

Contenido relacionado

• Acceso remoto
• Tailscale