Plusieurs Gateways

La plupart des configurations ne nécessitent qu’un seul Gateway : un Gateway unique gère plusieurs connexions de messagerie et agents. N’exécutez des Gateways distincts avec des profils et ports isolés que si vous avez besoin d’une isolation renforcée ou d’une redondance (par exemple, un bot de secours).

Démarrage rapide du bot de secours

La configuration la plus simple pour un bot de secours :

• Conservez le bot principal sur le profil par défaut.
• Exécutez le bot de secours avec --profile rescue, en lui attribuant son propre jeton de bot Telegram.
• Utilisez un autre port de base pour le bot de secours, par exemple 19789.

Ainsi, le bot de secours peut toujours diagnostiquer les problèmes ou appliquer des modifications de configuration si le bot principal est indisponible. Laissez au moins 20 ports d’écart entre les ports de base afin d’éviter tout conflit entre les ports dérivés du navigateur et de CDP.

# Bot de secours (bot Telegram distinct, profil distinct, port 19789)openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

Si votre bot principal est déjà en cours d’exécution, cela suffit généralement. Si l’intégration initiale a déjà installé le service de secours, ignorez la dernière commande gateway install.

Pendant openclaw --profile rescue onboard :

• Utilisez un jeton de bot Telegram distinct, réservé au compte de secours (facile à réserver aux opérateurs, indépendant de l’installation du canal ou de l’application du bot principal, et offrant une méthode simple de récupération par message privé).
• Conservez le nom de profil rescue.
• Utilisez un port de base supérieur d’au moins 20 à celui du bot principal.
• Acceptez l’espace de travail de secours par défaut, sauf si vous en gérez déjà un vous-même.

Modifications apportées par --profile rescue onboard

--profile rescue onboard exécute le processus normal d’intégration initiale, mais écrit toutes les données dans un profil distinct. Le bot de secours dispose ainsi de ses propres éléments :

• Fichier de profil et de configuration
• Répertoire d’état
• Espace de travail (par défaut : ~/.openclaw/workspace-rescue)
• Nom du service géré
• Port de base (ainsi que les ports dérivés)
• Jeton de bot Telegram

Les autres invites sont identiques à celles de l’intégration initiale normale.

Configuration générale de plusieurs Gateways

Le même modèle d’isolation fonctionne pour toute paire ou tout groupe de Gateways sur un même hôte : attribuez à chaque Gateway supplémentaire son propre profil nommé et son propre port de base :

# principal (profil par défaut)openclaw setupopenclaw gateway --port 18789 # Gateway supplémentaireopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789

Il est également possible d’utiliser des profils nommés des deux côtés :

openclaw --profile main setupopenclaw --profile main gateway --port 18789 openclaw --profile ops setupopenclaw --profile ops gateway --port 19789

Les services suivent le même modèle :

openclaw gateway installopenclaw --profile ops gateway install --port 19789

Utilisez le démarrage rapide du bot de secours pour disposer d’un canal opérateur de repli. Utilisez le modèle général fondé sur les profils pour plusieurs Gateways persistants répartis entre différents canaux, locataires, espaces de travail ou rôles opérationnels.

Liste de contrôle de l’isolation

Veillez à ce que les paramètres suivants soient uniques pour chaque instance de Gateway :

Le partage de l’un de ces éléments provoque des accès concurrents à la configuration et des conflits de ports.

Mappage des ports (dérivés)

Port de base = gateway.port (ou OPENCLAW_GATEWAY_PORT / --port).

• Port du service de contrôle du navigateur = port de base + 2 (local loopback uniquement).
• L’hôte Canvas est servi directement par le serveur HTTP du Gateway (sur le même port que gateway.port).
• Les ports CDP des profils de navigateur sont automatiquement attribués de port de contrôle du navigateur + 9 à + 108.

Si vous remplacez l’une de ces valeurs dans la configuration ou l’environnement, vous devez veiller à ce qu’elle reste unique pour chaque instance.

Remarques sur le navigateur et CDP (piège courant)

• Ne définissez pas browser.cdpUrl sur la même valeur pour plusieurs instances.
• Chaque instance nécessite son propre port de contrôle du navigateur et sa propre plage CDP (dérivés de son port de Gateway).
• Pour utiliser des ports CDP explicites, définissez browser.profiles.<name>.cdpPort pour chaque instance.
• Pour une instance distante de Chrome, utilisez browser.profiles.<name>.cdpUrl (pour chaque profil et chaque instance).

Exemple manuel avec des variables d’environnement

OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \OPENCLAW_STATE_DIR=~/.openclaw \openclaw gateway --port 18789 OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \OPENCLAW_STATE_DIR=~/.openclaw-rescue \openclaw gateway --port 19789

Vérifications rapides

openclaw gateway status --deepopenclaw --profile rescue gateway status --deepopenclaw --profile rescue gateway probeopenclaw statusopenclaw --profile rescue statusopenclaw --profile rescue browser status

• gateway status --deep détecte les services launchd/systemd/schtasks obsolètes provenant d’anciennes installations.
• Un avertissement de gateway probe tel que multiple reachable gateway identities detected n’est attendu que si vous exécutez volontairement plusieurs Gateways isolés, ou si OpenClaw ne peut pas établir que les cibles de sonde accessibles correspondent au même Gateway. Un tunnel SSH, une URL de proxy ou une URL distante configurée vers le même Gateway représente un seul Gateway utilisant plusieurs modes de transport, même si les ports de transport diffèrent.

Pages connexes

• Guide d’exploitation du Gateway
• Verrou du Gateway
• Configuration