Exécuter OpenClaw.app avec un Gateway distant

OpenClaw.app accède à un Gateway distant au moyen d’un tunnel SSH : une directive SSH LocalForward associe un port local au port WebSocket du Gateway sur l’hôte distant.

flowchart TB
    subgraph Client["Machine cliente"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(port local)"]
        T["Tunnel SSH"]

        A --> B
        B --> T
    end
    subgraph Remote["Machine distante"]
        direction TB
        C["WebSocket du Gateway"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

Configuration

1. Ajoutez une entrée à la configuration SSH avec LocalForward 18789 127.0.0.1:18789 (consultez Accès distant pour obtenir le bloc de configuration complet).
2. Copiez votre clé SSH sur l’hôte distant avec ssh-copy-id.
3. Définissez gateway.remote.token (ou gateway.remote.password) à l’aide de openclaw config set gateway.remote.token "<your-token>".
4. Démarrez le tunnel : ssh -N remote-gateway &.
5. Quittez puis rouvrez OpenClaw.app.

Pour disposer d’un tunnel qui persiste après les redémarrages et se reconnecte automatiquement, utilisez plutôt la configuration LaunchAgent présentée sur la page Accès distant qu’une commande manuelle ssh -N.

Fonctionnement

OpenClaw.app se connecte à ws://127.0.0.1:18789 sur la machine cliente. Le tunnel transfère cette connexion vers le port 18789 de l’hôte distant sur lequel s’exécute le Gateway.

Pages connexes

• Accès distant
• Tailscale