Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Most TCP został usunięty. Aktualne kompilacje OpenClaw nie dostarczają odbiornika mostu, a klucze konfiguracji bridge.* nie znajdują się już w schemacie. Ta strona jest zachowana wyłącznie jako odniesienie historyczne. Użyj protokołu Gateway dla wszystkich klientów węzłów/operatorów.

​
Dlaczego istniał

  • Granica bezpieczeństwa: most udostępnia małą listę dozwolonych elementów zamiast pełnej powierzchni API Gateway.
  • Parowanie + tożsamość węzła: przyjmowanie węzłów jest zarządzane przez Gateway i powiązane z tokenem przypisanym do węzła.
  • UX wykrywania: węzły mogą wykrywać Gateway przez Bonjour w sieci LAN albo łączyć się bezpośrednio przez sieć tailnet.
  • WS local loopback: pełna płaszczyzna sterowania WS pozostaje lokalna, chyba że zostanie tunelowana przez SSH.

​
Transport

  • TCP, jeden obiekt JSON na linię (JSONL).
  • Opcjonalne TLS (gdy bridge.tls.enabled ma wartość true).
  • Historyczny domyślny port odbiornika to 18790 (aktualne kompilacje nie uruchamiają mostu TCP).
Gdy TLS jest włączone, rekordy TXT wykrywania zawierają bridgeTls=1 oraz bridgeTlsSha256 jako niejawną wskazówkę. Pamiętaj, że rekordy TXT Bonjour/mDNS nie są uwierzytelniane; klienci nie mogą traktować ogłaszanego odcisku jako autorytatywnego przypięcia bez wyraźnej intencji użytkownika lub innej weryfikacji poza pasmem.

​
Uzgadnianie + parowanie

  1. Klient wysyła hello z metadanymi węzła + tokenem (jeśli jest już sparowany).
  2. Jeśli nie jest sparowany, Gateway odpowiada error (NOT_PAIRED/UNAUTHORIZED).
  3. Klient wysyła pair-request.
  4. Gateway czeka na zatwierdzenie, a następnie wysyła pair-ok i hello-ok.
Historycznie hello-ok zwracało serverName; hostowane powierzchnie Plugin są teraz ogłaszane przez pluginSurfaceUrls. Canvas/A2UI używa pluginSurfaceUrls.canvas; przestarzały alias canvasHostUrl nie jest częścią przeprojektowanego protokołu.

​
Ramki

Klient → Gateway:
  • req / res: zakresowe RPC Gateway (czat, sesje, konfiguracja, kondycja, voicewake, skills.bins)
  • event: sygnały węzła (transkrypcja głosu, żądanie agenta, subskrypcja czatu, cykl życia exec)
Gateway → klient:
  • invoke / invoke-res: polecenia węzła (canvas.*, camera.*, screen.record, location.get, sms.send)
  • event: aktualizacje czatu dla subskrybowanych sesji
  • ping / pong: keepalive
Starsze wymuszanie listy dozwolonych elementów znajdowało się w src/gateway/server-bridge.ts (usunięte).

​
Zdarzenia cyklu życia exec

Węzły mogą emitować zdarzenia exec.finished lub exec.denied, aby ujawniać aktywność system.run. Są one mapowane na zdarzenia systemowe w Gateway. (Starsze węzły mogą nadal emitować exec.started.) Pola payloadu (wszystkie opcjonalne, chyba że zaznaczono inaczej):
  • sessionKey (wymagane): sesja agenta, która ma otrzymać zdarzenie systemowe.
  • runId: unikalny identyfikator exec do grupowania.
  • command: surowy lub sformatowany ciąg polecenia.
  • exitCode, timedOut, success, output: szczegóły zakończenia (tylko finished).
  • reason: przyczyna odmowy (tylko denied).

​
Historyczne użycie tailnet

  • Powiąż most z adresem IP tailnet: bridge.bind: "tailnet" w ~/.openclaw/openclaw.json (tylko historycznie; bridge.* nie jest już prawidłowe).
  • Klienci łączą się przez nazwę MagicDNS lub adres IP tailnet.
  • Bonjour nie działa między sieciami; w razie potrzeby użyj ręcznego hosta/portu lub szerokoobszarowego DNS-SD.

​
Wersjonowanie

Most był niejawnym v1 (bez negocjacji min./maks.). Ta sekcja jest wyłącznie odniesieniem historycznym; aktualni klienci węzłów/operatorów używają WebSocket protokołu Gateway.

​
Powiązane