Skip to main content
TCP köprüsü kaldırıldı. Güncel OpenClaw derlemeleri köprü dinleyicisini içermez ve bridge.* yapılandırma anahtarları artık şemada yer almaz. Bu sayfa yalnızca geçmişe yönelik başvuru içindir. Tüm Node/operatör istemcileri için Gateway protokolünü kullanın.

​
Neden vardı?

  • Güvenlik sınırı: Gateway API yüzeyinin tamamı yerine küçük bir izin verilenler listesi sunuyordu.
  • Eşleştirme + Node kimliği: Node kabulü Gateway tarafından yönetiliyor ve Node başına bir belirtece bağlanıyordu.
  • Keşif kullanıcı deneyimi: Node’lar LAN üzerinde Bonjour aracılığıyla Gateway’leri keşfedebiliyor veya bir tailnet üzerinden doğrudan bağlanabiliyordu.
  • Geri döngü WS: WS denetim düzleminin tamamı, SSH üzerinden tünellenmediği sürece yerel kalıyordu.

​
Aktarım

  • TCP, satır başına bir JSON nesnesi (JSONL).
  • İsteğe bağlı TLS (bridge.tls.enabled: true).
  • Varsayılan dinleyici bağlantı noktası 18790 idi.
TLS etkinleştirildiğinde keşif TXT kayıtları, gizli olmayan bir ipucu olarak bridgeTls=1 ile birlikte bridgeTlsSha256 içeriyordu. Bonjour/mDNS TXT kayıtları kimliği doğrulanmamış kayıtlardır; istemciler, başka bir bant dışı doğrulama olmadan duyurulan parmak izini yetkili bir sabitleme değeri olarak kabul edemezdi.

​
El sıkışma ve eşleştirme

  1. İstemci, Node meta verileriyle ve önceden eşleştirilmişse belirteçle birlikte hello gönderir.
  2. Eşleştirilmemişse Gateway, error (NOT_PAIRED / UNAUTHORIZED) ile yanıt verir.
  3. İstemci pair-request gönderir.
  4. Gateway onay bekler, ardından pair-ok ve hello-ok gönderir.
hello-ok eskiden serverName döndürüyordu; barındırılan Plugin yüzeyleri artık güncel Gateway protokolünde pluginSurfaceUrls aracılığıyla duyurulur (Canvas/A2UI, pluginSurfaceUrls.canvas kullanır).

​
Çerçeveler

İstemciden Gateway’e:
  • req / res: kapsamı belirlenmiş Gateway RPC’si (sohbet, oturumlar, yapılandırma, sistem durumu, sesle uyandırma, skills.bins).
  • event: Node sinyalleri (ses dökümü, aracı isteği, sohbet aboneliği, yürütme yaşam döngüsü).
Gateway’den istemciye:
  • invoke / invoke-res: Node komutları (canvas.*, camera.*, screen.record, location.get, sms.send).
  • event: abone olunan oturumlar için sohbet güncellemeleri.
  • ping / pong: bağlantıyı canlı tutma.
İzin verilenler listesinin uygulanması src/gateway/server-bridge.ts içinde yer alıyordu (kaldırıldı).

​
Yürütme yaşam döngüsü olayları

Node’lar, tamamlanan system.run etkinliğini göstermek için exec.finished yayımlıyor ve bu etkinlik Gateway tarafından sistem olaylarıyla eşleniyordu (eski Node’lar ayrıca exec.started yayımlayabiliyordu). exec.denied, reddedilen bir system.run girişimini sistem olayı kuyruğa alınmadan veya aracı çalışması uyandırılmadan nihai bir ret olarak işaretliyordu. Yük alanları (belirtilmediği sürece tümü isteğe bağlıdır):

​
Geçmişteki tailnet kullanımı

  • Köprüyü bir tailnet IP’sine bağlayın: ~/.openclaw/openclaw.json içinde bridge.bind: "tailnet" (yalnızca geçmişe yöneliktir; bridge.* artık geçerli bir yapılandırma değildir).
  • İstemciler MagicDNS adı veya tailnet IP’si üzerinden bağlanıyordu.
  • Bonjour ağlar arasında çalışmaz; aksi durumda geniş alan DNS-SD veya manuel bir ana makine/bağlantı noktası gerekiyordu.

​
Sürüm oluşturma

Köprü, minimum/maksimum uzlaşması olmayan örtük bir v1 idi. Güncel Node/operatör istemcileri, protokol sürümü aralığı için uzlaşma yapan WebSocket Gateway protokolünü kullanır.

​
İlgili