Gateway
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 u sterkere isolatie of redundantie nodig hebt (bijvoorbeeld een reddingsbot).
Snelstart voor een reddingsbot
De eenvoudigste configuratie voor een reddingsbot:
- Houd de hoofdbot op het standaardprofiel.
- Voer de reddingsbot uit met
--profile rescueen een eigen Telegram-bottoken. - Gebruik voor de reddingsbot een andere basispoort, bijvoorbeeld
19789.
Zo kan de reddingsbot problemen 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 19789Als uw hoofdbot al actief is, is dit doorgaans alles wat u nodig hebt. Als de onboarding de reddingsservice al heeft geïnstalleerd, slaat u de laatste gateway install over.
Tijdens openclaw --profile rescue onboard:
- Gebruik een afzonderlijk Telegram-bottoken dat uitsluitend voor het reddingsaccount bestemd is (eenvoudig te beperken tot operators, onafhankelijk van de kanaal-/appinstallatie van de hoofdbot en een eenvoudig herstelpad via privéberichten).
- Behoud de profielnaam
rescue. - Gebruik een basispoort die ten minste 20 hoger is dan die van de hoofdbot.
- Accepteer de standaardwerkruimte voor de reddingsbot, tenzij u er zelf al een beheert.
Wat --profile rescue onboard wijzigt
--profile rescue onboard voert de normale onboarding uit, maar schrijft alles naar een afzonderlijk profiel. Daardoor krijgt de reddingsbot een eigen:
- Profiel-/configuratiebestand
- Statusmap
- Werkruimte (standaard:
~/.openclaw/workspace-rescue) - Naam van de beheerde service
- Basispoort (plus afgeleide poorten)
- Telegram-bottoken
De prompts zijn verder hetzelfde als bij 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:
# hoofd-Gateway (standaardprofiel)openclaw setupopenclaw gateway --port 18789 # extra Gatewayopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789Benoemde profielen aan beide kanten werken ook:
openclaw --profile main setupopenclaw --profile main gateway --port 18789 openclaw --profile ops setupopenclaw --profile ops gateway --port 19789Services volgen hetzelfde patroon:
openclaw gateway installopenclaw --profile ops gateway install --port 19789Gebruik de snelstart voor een reddingsbot als terugvalkanaal 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:
| Instelling | Doel |
|---|---|
OPENCLAW_CONFIG_PATH |
Configuratiebestand per instantie |
OPENCLAW_STATE_DIR |
Sessies, referenties en caches per instantie |
agents.defaults.workspace |
Hoofdmap van de werkruimte per instantie |
gateway.port (of --port) |
Uniek per instantie |
| Afgeleide browser-/CDP-poorten | Zie hieronder |
Het delen van een van deze instellingen veroorzaakt configuratieraces en poortconflicten.
Poorttoewijzing (afgeleid)
Basispoort = gateway.port (of OPENCLAW_GATEWAY_PORT / --port).
- Poort van de browserbesturingsservice = basispoort + 2 (alleen local loopback).
- De Canvas-host wordt aangeboden via de HTTP-server van de Gateway zelf (dezelfde poort als
gateway.port). - CDP-poorten voor browserprofielen worden automatisch toegewezen vanaf
browser control port + 9tot en met+ 108.
Als u een van deze instellingen in de configuratie of via omgevingsvariabelen overschrijft, moet u ervoor zorgen dat deze per instantie uniek blijven.
Opmerkingen over browser/CDP (veelvoorkomende valkuil)
- Stel
browser.cdpUrlniet voor meerdere instanties in op dezelfde vaste waarde. - Elke instantie heeft een eigen browserbesturingspoort en CDP-bereik nodig (afgeleid van de Gateway-poort).
- Stel voor expliciete CDP-poorten
browser.profiles.<name>.cdpPortper instantie in. - Gebruik voor Chrome op afstand
browser.profiles.<name>.cdpUrl(per profiel, per instantie).
Handmatig voorbeeld met omgevingsvariabelen
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 19789Snelle controles
openclaw gateway status --deepopenclaw --profile rescue gateway status --deepopenclaw --profile rescue gateway probeopenclaw statusopenclaw --profile rescue statusopenclaw --profile rescue browser statusgateway status --deepdetecteert verouderde launchd-/systemd-/schtasks-services van oudere installaties.- Waarschuwingstekst van
gateway probe, zoalsmultiple reachable gateway identities detected, wordt alleen verwacht wanneer u opzettelijk meer dan één geïsoleerde Gateway uitvoert, of wanneer OpenClaw niet kan bewijzen dat bereikbare probedoelen dezelfde Gateway zijn. Een SSH-tunnel, proxy-URL of geconfigureerde externe URL naar dezelfde Gateway betreft één Gateway met meerdere transportmethoden, zelfs wanneer de transportpoorten verschillen.