Skip to main content

​
Plusieurs Gateways (même hôte)

La plupart des configurations devraient utiliser une seule Gateway, car une Gateway unique peut gérer plusieurs connexions de messagerie et agents. Si vous avez besoin d’une isolation ou d’une redondance plus fortes (par exemple, un bot de secours), exécutez des Gateways séparées avec des profils et des ports isolés.

​
Liste de contrôle d’isolation (obligatoire)

  • OPENCLAW_CONFIG_PATH — fichier de configuration par instance
  • OPENCLAW_STATE_DIR — sessions, identifiants et caches par instance
  • agents.defaults.workspace — racine de l’espace de travail par instance
  • gateway.port (ou --port) — unique par instance
  • Les ports dérivés (navigateur/canvas) ne doivent pas se chevaucher
Si ces éléments sont partagés, vous rencontrerez des conflits de configuration et de ports.

​
Recommandé : profils (--profile)

Les profils délimitent automatiquement OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH et ajoutent un suffixe aux noms de service.
Services par profil :

​
Guide du bot de secours

Exécutez une deuxième Gateway sur le même hôte avec ses propres :
  • profil/configuration
  • répertoire d’état
  • espace de travail
  • port de base (plus les ports dérivés)
Cela maintient le bot de secours isolé du bot principal afin qu’il puisse déboguer ou appliquer des changements de configuration si le bot principal est hors service. Espacement des ports : laissez au moins 20 ports entre les ports de base afin que les ports dérivés du navigateur/canvas/CDP n’entrent jamais en collision.

​
Comment installer (bot de secours)

​
Mappage des ports (dérivés)

Port de base = gateway.port (ou OPENCLAW_GATEWAY_PORT / --port).
  • port du service de contrôle du navigateur = base + 2 (loopback uniquement)
  • le canvas host est servi sur le serveur HTTP du Gateway (même port que gateway.port)
  • Les ports CDP du profil de navigateur s’allouent automatiquement à partir de browser.controlPort + 9 .. + 108
Si vous remplacez l’un de ces paramètres dans la configuration ou les variables d’environnement, vous devez les maintenir uniques par instance.

​
Notes sur le navigateur/CDP (piège courant)

  • Ne fixez pas browser.cdpUrl aux mêmes valeurs sur plusieurs instances.
  • Chaque instance a besoin de son propre port de contrôle du navigateur et de sa propre plage CDP (dérivés de son port de gateway).
  • Si vous avez besoin de ports CDP explicites, définissez browser.profiles.<name>.cdpPort par instance.
  • Chrome distant : utilisez browser.profiles.<name>.cdpUrl (par profil, par instance).

​
Exemple manuel avec variables d’environnement

​
Vérifications rapides