Gateway

Köprü protokolü

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

İstemci, Node meta verileriyle ve önceden eşleştirilmişse belirteçle birlikte hello gönderir.
Eşleştirilmemişse Gateway, error (NOT_PAIRED / UNAUTHORIZED) ile yanıt verir.
İstemci pair-request gönderir.
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):

Alan	Notlar
`sessionKey`	Zorunlu. Olay ilişkilendirmesi ve `exec.finished` için sistem olayı tesliminde kullanılan aracı oturumu.
`runId`	Gruplandırma için benzersiz yürütme kimliği.
`command`	Ham veya biçimlendirilmiş komut dizesi.
`exitCode`, `timedOut`, `output`	Tamamlanma ayrıntıları (yalnızca tamamlananlar).
`reason`	Ret nedeni (yalnızca reddedilenler).

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

Was this useful?