Bu sayfada
Bu sayfada
Gateway
Birden çok Gateway
Çoğu kurulum için 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ış profillere/portlara sahip 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, ör.
19789portuna yerleştirin.
Bu, birincil bot çalışmıyorsa kurtarma botunun hata ayıklayabilmesini veya yapılandırma değişiklikleri uygulayabilmesini sağlar. Türetilen tarayıcı/CDP portlarının hiçbir zaman çakışmaması için temel portlar arasında en az 20 port bırakın.
Ana botunuz zaten çalışıyorsa genellikle gerekenlerin tümü budur. İlk katılım kurtarma hizmetini zaten yüklediyse son gateway install adımını atlayın.
openclaw --profile rescue onboard sırasında:
- Kurtarma hesabına ayrılmış ayrı bir Telegram bot token'ı kullanın (yalnızca operatörlere açık tutması kolaydır, ana botun kanal/uygulama kurulumundan bağımsızdır ve DM tabanlı basit bir kurtarma yolu sağlar).
rescueprofil 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 şunlara 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üretilen 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 geçerlidir; her ek Gateway'e kendi adlandırılmış profilini ve temel portunu verin:
Her iki tarafta adlandırılmış profiller de kullanılabilir:
Hizmetler de aynı düzeni izler:
Yedek operatör hattı için kurtarma botu hızlı başlangıcını; farklı kanallar, kiracılar, çalışma alanları veya operasyonel roller genelinde uzun süre çalışan birden fazla 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, önbellekler |
agents.defaults.workspace |
Örneğe özgü çalışma alanı kökü |
gateway.port (veya --port) |
Her örnek için benzersiz |
| Türetilen tarayıcı/CDP portları | Aşağıya bakın |
Bunlardan herhangi birinin paylaşılması yapılandırma, durum veya port çakışmalarına neden olur. Gateway başlangıcı,
OPENCLAW_ALLOW_MULTI_GATEWAY=1 yapılandırma başına tek örnek kuralını atlasa bile
durum dizini sahipliğinin benzersiz olmasını zorunlu kılar.
Port eşlemesi (türetilen)
Temel port = gateway.port (veya OPENCLAW_GATEWAY_PORT / --port).
- Tarayıcı denetim hizmeti portu = temel + 2 (yalnızca geri döngü).
- Canvas ana makinesi doğrudan Gateway HTTP sunucusunda sunulur (
gateway.portile aynı port). - Tarayıcı profili CDP portları,
browser control port + 9ile+ 108arası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 tuzak)
browser.cdpUrldeğerini birden fazla örnekte aynı değere sabitlemeyin.- Her örnek için kendi tarayıcı denetim portu ve CDP aralığı (Gateway portundan türetilir) gerekir.
- Açık CDP portları için her örnekte
browser.profiles.<name>.cdpPortdeğerini ayarlayın. - Uzak Chrome için
browser.profiles.<name>.cdpUrlkullanın (profil ve örnek başına).
Elle ortam değişkeni örneği
Hızlı kontroller
gateway status --deep, eski kurulumlardan kalan güncelliğini yitirmiş launchd/systemd/schtasks hizmetlerini yakalar.gateway probeuyarı metninin, örneğinmultiple reachable gateway identities detected, yalnızca birden fazla yalıtılmış Gateway'i kasıtlı olarak çalıştırdığınızda veya OpenClaw erişilebilir yoklama hedeflerinin aynı Gateway olduğunu doğrulayamadığında görülmesi 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.