Przejdź do głównej treści

​
Wiele Gateway (ten sam host)

Większość konfiguracji powinna używać jednego Gateway, ponieważ pojedynczy Gateway może obsługiwać wiele połączeń komunikatorów i agentów. Jeśli potrzebujesz silniejszej izolacji lub redundancji (np. bota ratunkowego), uruchom oddzielne Gateway z izolowanymi profilami/portami.

​
Lista kontrolna izolacji (wymagane)

  • OPENCLAW_CONFIG_PATH — plik konfiguracji na instancję
  • OPENCLAW_STATE_DIR — sesje, poświadczenia i cache na instancję
  • agents.defaults.workspace — katalog roboczy workspace na instancję
  • gateway.port (lub --port) — unikalne dla każdej instancji
  • Pochodne porty (przeglądarka/canvas) nie mogą się nakładać
Jeśli te zasoby są współdzielone, napotkasz wyścigi konfiguracji i konflikty portów.

​
Zalecane: profile (--profile)

Profile automatycznie zakresują OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH i dodają sufiks do nazw usług. 
# main
openclaw --profile main setup
openclaw --profile main gateway --port 18789

# rescue
openclaw --profile rescue setup
openclaw --profile rescue gateway --port 19001
Usługi per profil: 
openclaw --profile main gateway install
openclaw --profile rescue gateway install

​
Przewodnik bota ratunkowego

Uruchom drugi Gateway na tym samym hoście z własnymi:
  • profilem/konfiguracją
  • katalog stanu
  • obszar roboczy
  • portem bazowym (plus porty pochodne)
Dzięki temu bot ratunkowy jest odizolowany od głównego bota i może diagnozować problemy lub stosować zmiany konfiguracji, gdy podstawowy bot jest niedostępny. Odstęp portów: pozostaw co najmniej 20 portów między portami bazowymi, aby pochodne porty przeglądarki/canvas/CDP nigdy się nie zderzały.

​
Jak zainstalować (bot ratunkowy)

# Main bot (existing or fresh, without --profile param)
# Runs on port 18789 + Chrome CDC/Canvas/... Ports
openclaw onboard
openclaw gateway install

# Rescue bot (isolated profile + ports)
openclaw --profile rescue onboard
# Notes:
# - workspace name will be postfixed with -rescue per default
# - Port should be at least 18789 + 20 Ports,
#   better choose completely different base port, like 19789,
# - rest of the onboarding is the same as normal

# To install the service (if not happened automatically during onboarding)
openclaw --profile rescue gateway install

​
Mapowanie portów (pochodne)

Port bazowy = gateway.port (lub OPENCLAW_GATEWAY_PORT / --port).
  • port usługi sterowania przeglądarką = baza + 2 (tylko local loopback)
  • host canvas jest udostępniany przez serwer HTTP Gateway (ten sam port co gateway.port)
  • Porty CDP profilu przeglądarki są automatycznie alokowane z browser.controlPort + 9 .. + 108
Jeśli nadpiszesz którykolwiek z nich w konfiguracji lub zmiennych środowiskowych, musisz zachować ich unikalność dla każdej instancji.

​
Uwagi dotyczące przeglądarki/CDP (częsta pułapka)

  • Nie przypinaj browser.cdpUrl do tych samych wartości na wielu instancjach.
  • Każda instancja potrzebuje własnego portu sterowania przeglądarką i zakresu CDP (pochodnego od portu gateway).
  • Jeśli potrzebujesz jawnych portów CDP, ustaw browser.profiles.<name>.cdpPort per instancję.
  • Zdalny Chrome: użyj browser.profiles.<name>.cdpUrl (per profil, per instancję).

​
Przykład ręczny (env)

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

OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \
OPENCLAW_STATE_DIR=~/.openclaw-rescue \
openclaw gateway --port 19001

​
Szybkie kontrole

openclaw --profile main status
openclaw --profile rescue status
openclaw --profile rescue browser status