Meerdere gateways

Voor de meeste configuraties is één Gateway nodig: één Gateway verwerkt meerdere berichtenverbindingen en agents. Voer afzonderlijke Gateways met geïsoleerde profielen/poorten alleen uit wanneer je sterkere isolatie of redundantie nodig hebt (bijvoorbeeld een reddingsbot).

Snelstart voor reddingsbot

De eenvoudigste configuratie voor een reddingsbot:

• Houd de hoofdbot op het standaardprofiel.
• Voer de reddingsbot uit op --profile rescue, met een eigen Telegram-bottoken.
• Gebruik voor de reddingsbot een andere basispoort, bijvoorbeeld 19789.

Hierdoor kan de reddingsbot problemen blijven opsporen of configuratiewijzigingen toepassen als de primaire bot niet beschikbaar is. Laat ten minste 20 poorten vrij tussen basispoorten, zodat afgeleide browser-/CDP-poorten nooit conflicteren.

# Reddingsbot (afzonderlijke Telegram-bot, afzonderlijk profiel, poort 19789)openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

Als je hoofdbot al actief is, is dit doorgaans alles wat je nodig hebt. Als de onboarding de reddingsservice al heeft geïnstalleerd, sla je de laatste gateway install over.

Tijdens openclaw --profile rescue onboard:

• Gebruik een afzonderlijk Telegram-bottoken dat specifiek voor het reddingsaccount is bedoeld (eenvoudig uitsluitend voor operators te houden, onafhankelijk van de kanaal-/appinstallatie van de hoofdbot en een eenvoudig herstelpad via DM).
• Behoud de profielnaam rescue.
• Gebruik een basispoort die ten minste 20 hoger is dan die van de hoofdbot.
• Accepteer de standaardwerkruimte voor redding, tenzij je er zelf al een beheert.

Wat --profile rescue onboard verandert

--profile rescue onboard voert de normale onboardingflow uit, maar schrijft alles naar een afzonderlijk profiel, zodat de reddingsbot een eigen exemplaar krijgt van:

• Profiel-/configuratiebestand
• Statusmap
• Werkruimte (standaard: ~/.openclaw/workspace-rescue)
• Naam van beheerde service
• Basispoort (plus afgeleide poorten)
• Telegram-bottoken

De prompts zijn verder identiek aan die van de normale onboarding.

Algemene configuratie met meerdere Gateways

Hetzelfde isolatiepatroon werkt voor elk paar of elke groep Gateways op één host: geef elke extra Gateway een eigen benoemd profiel en een eigen basispoort:

# hoofdgateway (standaardprofiel)openclaw setupopenclaw gateway --port 18789 # extra gatewayopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789

Benoemde profielen aan beide kanten werken ook:

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

Services volgen hetzelfde patroon:

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

Gebruik de snelstart voor de reddingsbot voor een uitwijkkanaal voor operators; gebruik het algemene profielpatroon voor meerdere langdurig actieve Gateways voor verschillende kanalen, tenants, werkruimten of operationele rollen.

Controlelijst voor isolatie

Houd deze instellingen uniek per Gateway-instantie:

Het delen van een van deze instellingen veroorzaakt conflicten met configuratie, status of poorten. Bij het starten van de Gateway wordt uniek eigendom van de statusmap afgedwongen, zelfs wanneer OPENCLAW_ALLOW_MULTI_GATEWAY=1 de singleton per configuratie overslaat.

Poorttoewijzing (afgeleid)

Basispoort = gateway.port (of OPENCLAW_GATEWAY_PORT / --port).

• Poort van de browserbesturingsservice = basis + 2 (alleen loopback).
• De Canvas-host wordt aangeboden op de HTTP-server van de Gateway zelf (dezelfde poort als gateway.port).
• CDP-poorten voor browserprofielen worden automatisch toegewezen van browser control port + 9 tot en met + 108.

Als je een van deze waarden in de configuratie of omgeving overschrijft, moet je ze uniek houden per instantie.

Opmerkingen over browser/CDP (veelvoorkomende valkuil)

• Stel browser.cdpUrl niet vast op dezelfde waarde voor meerdere instanties.
• Elke instantie heeft een eigen browserbesturingspoort en CDP-bereik nodig (afgeleid van de gatewaypoort).
• Stel voor expliciete CDP-poorten browser.profiles.<name>.cdpPort per instantie in.
• Gebruik voor Chrome op afstand browser.profiles.<name>.cdpUrl (per profiel, per instantie).

Handmatig omgevingsvoorbeeld

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

Snelle controles

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

• gateway status --deep detecteert verouderde launchd-/systemd-/schtasks-services van oudere installaties.
• Waarschuwingstekst van gateway probe, zoals multiple reachable gateway identities detected, wordt alleen verwacht wanneer je opzettelijk meer dan één geïsoleerde Gateway uitvoert, of wanneer OpenClaw niet kan aantonen dat bereikbare probedoelen dezelfde Gateway zijn. Een SSH-tunnel, proxy-URL of geconfigureerde externe URL naar dezelfde Gateway is één Gateway met meerdere transporten, zelfs wanneer de transportpoorten verschillen.

Gerelateerd

• Gateway-draaiboek
• Gateway-vergrendeling
• Configuratie