Ejecución de OpenClaw.app con un Gateway remoto

OpenClaw.app accede 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ñada una entrada de configuración SSH con LocalForward 18789 127.0.0.1:18789 (consulte Acceso remoto para ver el bloque de configuración completo).
2. Copie la clave SSH al host remoto con ssh-copy-id.
3. Establezca gateway.remote.token (o gateway.remote.password) mediante openclaw config set gateway.remote.token "<your-token>".
4. Inicie el túnel: ssh -N remote-gateway &.
5. Cierre y vuelva a abrir OpenClaw.app.

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

Funcionamiento

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