Gateway

Birden fazla Gateway

Çoğu kurulumda tek bir Gateway gerekir; tek bir Gateway, birden fazla mesajlaşma bağlantısını ve ajanı yönetir. Yalnızca daha güçlü yalıtım veya yedeklilik gerektiğinde (ör. bir kurtarma botu) yalıtılmış profiller/portlarla ayrı Gateway'ler çalıştırın.

Kurtarma botu hızlı başlangıcı

En basit kurtarma botu kurulumu:

  • Ana botu varsayılan profilde tutun.
  • Kurtarma botunu kendi Telegram bot token'ıyla --profile rescue üzerinde çalıştırın.
  • Kurtarma botunu farklı bir temel porta, örneğin 19789 portuna yerleştirin.

Bu, birincil bot çalışmıyorsa kurtarma botunun hata ayıklayabilmesini veya yapılandırma değişiklikleri uygulayabilmesini sağlar. Türetilmiş tarayıcı/CDP portlarının hiçbir zaman çakışmaması için temel portlar arasında en az 20 port bırakın.

bash
# Kurtarma botu (ayrı Telegram botu, ayrı profil, port 19789)openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

Ana botunuz zaten çalışıyorsa genellikle ihtiyacınız olan tek şey budur. İlk katılım işlemi kurtarma hizmetini zaten yüklediyse son gateway install komutunu atlayın.

openclaw --profile rescue onboard sırasında:

  • Kurtarma hesabına ayrılmış ayrı bir Telegram bot token'ı kullanın (yalnızca operatöre açık tutması kolaydır, ana botun kanal/uygulama kurulumundan bağımsızdır ve DM tabanlı basit bir kurtarma yolu sağlar).
  • rescue profil adını koruyun.
  • Ana botunkinden en az 20 daha yüksek bir temel port kullanın.
  • Zaten kendiniz yönettiğiniz bir çalışma alanı yoksa varsayılan kurtarma çalışma alanını kabul edin.

--profile rescue onboard neleri değiştirir?

--profile rescue onboard, normal ilk katılım akışını çalıştırır ancak her şeyi ayrı bir profile yazar; böylece kurtarma botu kendine ait şu öğelere sahip olur:

  • Profil/yapılandırma dosyası
  • Durum dizini
  • Çalışma alanı (varsayılan: ~/.openclaw/workspace-rescue)
  • Yönetilen hizmet adı
  • Temel port (ve türetilmiş portlar)
  • Telegram bot token'ı

Bunun dışındaki istemler normal ilk katılımla aynıdır.

Genel çoklu Gateway kurulumu

Aynı yalıtım düzeni, tek bir ana makinedeki herhangi bir Gateway çifti veya grubu için çalışır; her ek Gateway'e kendi adlandırılmış profilini ve temel portunu verin:

bash
# ana (varsayılan profil)openclaw setupopenclaw gateway --port 18789 # ek gatewayopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789

Her iki tarafta da adlandırılmış profiller kullanmak mümkündür:

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

Hizmetler de aynı düzeni izler:

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

Yedek bir operatör hattı için kurtarma botu hızlı başlangıcını; farklı kanallar, kiracılar, çalışma alanları veya operasyonel roller arasında birden fazla uzun ömürlü Gateway için genel profil düzenini kullanın.

Yalıtım kontrol listesi

Her Gateway örneği için şunları benzersiz tutun:

Ayar Amaç
OPENCLAW_CONFIG_PATH Örneğe özgü yapılandırma dosyası
OPENCLAW_STATE_DIR Örneğe özgü oturumlar, kimlik bilgileri ve önbellekler
agents.defaults.workspace Örneğe özgü çalışma alanı kökü
gateway.port (veya --port) Her örnek için benzersiz
Türetilmiş tarayıcı/CDP portları Aşağıya bakın

Bunlardan herhangi birinin paylaşılması, yapılandırma yarışlarına ve port çakışmalarına neden olur.

Port eşlemesi (türetilmiş)

Temel port = gateway.port (veya OPENCLAW_GATEWAY_PORT / --port).

  • Tarayıcı denetim hizmeti portu = temel + 2 (yalnızca local loopback).
  • Canvas ana makinesi doğrudan Gateway HTTP sunucusunda sunulur (gateway.port ile aynı port).
  • Tarayıcı profili CDP portları, browser control port + 9 ile + 108 aralığından otomatik olarak ayrılır.

Bunlardan herhangi birini yapılandırmada veya ortam değişkenlerinde geçersiz kılarsanız her örnek için benzersiz tutmanız gerekir.

Tarayıcı/CDP notları (yaygın hata kaynağı)

  • Birden fazla örnekte browser.cdpUrl değerini aynı değere sabitlemeyin.
  • Her örnek kendi tarayıcı denetim portuna ve CDP aralığına ihtiyaç duyar (Gateway portundan türetilir).
  • Açık CDP portları için her örnekte browser.profiles.<name>.cdpPort değerini ayarlayın.
  • Uzak Chrome için browser.profiles.<name>.cdpUrl kullanın (profil başına, örnek başına).

Manuel ortam değişkeni örneği

bash
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

Hızlı kontroller

bash
openclaw gateway status --deepopenclaw --profile rescue gateway status --deepopenclaw --profile rescue gateway probeopenclaw statusopenclaw --profile rescue statusopenclaw --profile rescue browser status
  • gateway status --deep, eski kurulumlardan kalan güncelliğini yitirmiş launchd/systemd/schtasks hizmetlerini yakalar.
  • multiple reachable gateway identities detected gibi gateway probe uyarı metinleri yalnızca kasıtlı olarak birden fazla yalıtılmış Gateway çalıştırdığınızda veya OpenClaw erişilebilir yoklama hedeflerinin aynı Gateway olduğunu doğrulayamadığında beklenir. Aynı Gateway'e yönelik bir SSH tüneli, proxy URL'si veya yapılandırılmış uzak URL, aktarım portları farklı olsa bile birden fazla aktarıma sahip tek bir Gateway'dir.

İlgili konular

Was this useful?
On this page

On this page