---
read_when: Connecting the macOS app to a remote gateway over SSH
summary: Configuration d’un tunnel SSH pour connecter OpenClaw.app à un Gateway distant
title: Configuration d’un Gateway distant
x-i18n:
    generated_at: "2026-07-12T02:40:23Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 842578eb74e99d115b04abff5e9673a6454fa6d2cf7905d056999469e1c6b66d
    source_path: gateway/remote-gateway-readme.md
    workflow: 16
---

<Note>
Ce contenu se trouve désormais dans [Accès distant](/fr/gateway/remote#macos-persistent-ssh-tunnel-via-launchagent). Consultez cette page pour obtenir le guide à jour ; cette page demeure une cible de redirection.
</Note>

# 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.

```mermaid
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](/fr/gateway/remote#macos-persistent-ssh-tunnel-via-launchagent) 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](/fr/gateway/remote#macos-persistent-ssh-tunnel-via-launchagent) qu’une commande manuelle `ssh -N`.

## Fonctionnement

| Composant                            | Fonction                                                       |
| ------------------------------------ | -------------------------------------------------------------- |
| `LocalForward 18789 127.0.0.1:18789` | Transfère le port local 18789 vers le port distant 18789        |
| `ssh -N`                             | Établit une connexion SSH sans exécuter de commandes distantes (transfert de port uniquement) |
| `KeepAlive`                          | Redémarre automatiquement le tunnel en cas d’arrêt inattendu (LaunchAgent) |
| `RunAtLoad`                          | Démarre le tunnel lors du chargement du LaunchAgent (LaunchAgent) |

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](/fr/gateway/remote)
- [Tailscale](/fr/gateway/tailscale)