Odkrywanie Bonjour

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.

​

Wide-area Bonjour (Unicast DNS-SD) przez Tailscale

1. Uruchom serwer DNS na hoście gateway (osiągalny przez Tailnet).
2. Opublikuj rekordy DNS-SD dla _openclaw-gw._tcp w dedykowanej strefie (przykład: openclaw.internal.).
3. Skonfiguruj Tailscale split DNS, aby wybrana domena była rozwiązywana przez ten serwer DNS dla klientów (w tym iOS).

​

Konfiguracja Gateway (zalecana)

{
  gateway: { bind: "tailnet" }, // tailnet-only (recommended)
  discovery: { wideArea: { enabled: true } }, // enables wide-area DNS-SD publishing
}

​

Jednorazowa konfiguracja serwera DNS (host gateway)

openclaw dns setup --apply

• nasłuchiwał na porcie 53 tylko na interfejsach Tailscale gateway
• obsługiwał wybraną domenę (przykład: openclaw.internal.) z ~/.openclaw/dns/<domain>.db

dns-sd -B _openclaw-gw._tcp openclaw.internal.
dig @<TAILNET_IPV4> -p 53 _openclaw-gw._tcp.openclaw.internal PTR +short

​

Ustawienia DNS Tailscale

• Dodaj serwer nazw wskazujący adres IP tailnet gateway (UDP/TCP 53).
• Dodaj split DNS, aby domena wykrywania używała tego serwera nazw.

​

Bezpieczeństwo listenera Gateway (zalecane)

• Ustaw gateway.bind: "tailnet" w ~/.openclaw/openclaw.json.
• Uruchom ponownie Gateway (lub aplikację paska menu macOS).

​

Co ogłasza usługi

​

Typy usług

• _openclaw-gw._tcp - beacon transportowy gateway (używany przez węzły macOS/iOS/Android).

​

Klucze TXT (niesekretne wskazówki)

• role=gateway
• displayName=<friendly name>
• lanHost=<hostname>.local
• gatewayPort=<port> (Gateway WS + HTTP)
• gatewayTls=1 (tylko gdy TLS jest włączony)
• gatewayTlsSha256=<sha256> (tylko gdy TLS jest włączony i odcisk palca jest dostępny)
• canvasPort=<port> (tylko gdy host canvas jest włączony; obecnie taki sam jak gatewayPort)
• transport=gateway
• tailnetDns=<magicdns> (tylko pełny tryb mDNS, opcjonalna wskazówka, gdy Tailnet jest dostępny)
• sshPort=<port> (tylko pełny tryb; pomijane w trybach minimalnym i wyłączonym)
• cliPath=<path> (tylko pełny tryb; pomijane w trybach minimalnym i wyłączonym)

• Rekordy TXT Bonjour/mDNS są nieuwierzytelnione. Klienci nie mogą traktować TXT jako autorytatywnego źródła trasowania.
• Klienci powinni trasować z użyciem rozwiązanego punktu końcowego usługi (SRV + A/AAAA). Traktuj lanHost, tailnetDns, gatewayPort i gatewayTlsSha256 wyłącznie jako wskazówki.
• Automatyczne wybieranie celu SSH powinno podobnie używać rozwiązanego hosta usługi, a nie wskazówek wyłącznie z TXT.
• Przypinanie TLS nigdy nie może pozwolić, aby ogłoszony gatewayTlsSha256 nadpisał wcześniej zapisany pin.
• Węzły iOS/Android powinny traktować bezpośrednie połączenia oparte na wykrywaniu jako wyłącznie TLS i wymagać jawnego potwierdzenia użytkownika przed zaufaniem pierwszemu odciskowi palca.

​

Debugowanie na macOS

• Przeglądanie instancji:
  dns-sd -B _openclaw-gw._tcp local.
  
• Rozwiązanie jednej instancji (zastąp <instance>):
  dns-sd -L "<instance>" _openclaw-gw._tcp local.
  

​

Debugowanie w logach Gateway

• bonjour: advertise failed ...
• bonjour: suppressing ciao cancellation ...
• bonjour: ... name conflict resolved / hostname conflict resolved
• bonjour: watchdog detected non-announced service ...
• bonjour: disabling advertiser after ... failed restarts ...

​

Debugowanie na węźle iOS

• Settings → Gateway → Advanced → Discovery Debug Logs
• Settings → Gateway → Advanced → Discovery Logs → odtwórz problem → Copy

​

Kiedy włączyć Bonjour

openclaw plugins enable bonjour

​

Kiedy wyłączyć Bonjour

OPENCLAW_DISABLE_BONJOUR=1

openclaw plugins disable bonjour

​

Pułapki Docker

• Bonjour uruchamia się automatycznie na hostach macOS i wymaga włączenia gdzie indziej. Pozostawienie go wyłączonego nie zatrzymuje Gateway; jedynie pomija ogłaszanie multicast w LAN.
• Wyłączenie Bonjour nie zmienia gateway.bind; Docker nadal domyślnie używa OPENCLAW_GATEWAY_BIND=lan, aby opublikowany port hosta mógł działać.
• Wyłączenie Bonjour nie wyłącza wide-area DNS-SD. Użyj wykrywania wide-area lub Tailnet, gdy Gateway i węzeł nie są w tej samej sieci LAN.
• Ponowne użycie tego samego OPENCLAW_CONFIG_DIR poza Docker nie utrwala polityki automatycznego wyłączenia kontenera.
• Ustaw OPENCLAW_DISABLE_BONJOUR=0 tylko dla sieci hosta, macvlan lub innej sieci, w której wiadomo, że multicast mDNS przechodzi; ustaw 1, aby wymusić wyłączenie.

​

Rozwiązywanie problemów z wyłączonym Bonjour

1. Potwierdź, czy Gateway działa w trybie automatycznym, wymuszonego włączenia czy wymuszonego wyłączenia:
   docker compose config | grep OPENCLAW_DISABLE_BONJOUR
   
2. Potwierdź, że sam Gateway jest osiągalny przez opublikowany port:
   curl -fsS http://127.0.0.1:18789/healthz
   
3. Użyj bezpośredniego celu, gdy Bonjour jest wyłączony:
   • UI sterowania lub narzędzia lokalne: http://127.0.0.1:18789
   • Klienci LAN: http://<gateway-host>:18789
   • Klienci między sieciami: Tailnet MagicDNS, IP Tailnet, tunel SSH lub wide-area DNS-SD
4. Jeśli celowo włączyłeś plugin Bonjour w Docker i wymusiłeś ogłaszanie za pomocą OPENCLAW_DISABLE_BONJOUR=0, przetestuj multicast z hosta:
   dns-sd -B _openclaw-gw._tcp local.
   
   Jeśli przeglądanie jest puste albo logi Gateway pokazują powtarzające się anulowania watchdog ciao, przywróć OPENCLAW_DISABLE_BONJOUR=1 i użyj bezpośredniej trasy lub trasy Tailnet.

​

Typowe tryby awarii

• Bonjour nie działa między sieciami: użyj Tailnet lub SSH.
• Multicast zablokowany: niektóre sieci Wi-Fi wyłączają mDNS.
• Advertiser utknął w probing/announcing: hosty z zablokowanym multicast, mostki kontenerów, WSL lub zmiany interfejsów mogą pozostawić advertiser ciao w stanie nieogłoszonym. OpenClaw ponawia próbę kilka razy, a potem wyłącza Bonjour dla bieżącego procesu Gateway zamiast restartować advertiser w nieskończoność.
• Sieć mostkowana Docker: Bonjour automatycznie wyłącza się w wykrytych kontenerach. Ustaw OPENCLAW_DISABLE_BONJOUR=0 tylko dla hosta, macvlan lub innej sieci zdolnej do mDNS.
• Uśpienie / zmiany interfejsów: macOS może tymczasowo tracić wyniki mDNS; spróbuj ponownie.
• Przeglądanie działa, ale rozwiązywanie się nie udaje: utrzymuj proste nazwy maszyn (unikaj emoji i interpunkcji), a następnie uruchom ponownie Gateway. Nazwa instancji usługi pochodzi od nazwy hosta, więc nadmiernie złożone nazwy mogą mylić niektóre resolvery.

​

Nazwy instancji z sekwencjami escape (\032)

• To normalne na poziomie protokołu.
• UI powinny dekodować je do wyświetlania (iOS używa BonjourEscapes.decode).

​

Włączanie / wyłączanie / konfiguracja

• Hosty macOS domyślnie automatycznie uruchamiają wbudowany Plugin wykrywania LAN.
• openclaw plugins enable bonjour włącza wbudowany Plugin wykrywania LAN na hostach, na których nie jest domyślnie włączony.
• openclaw plugins disable bonjour wyłącza rozgłaszanie multicast LAN przez wyłączenie wbudowanego Plugin.
• OPENCLAW_DISABLE_BONJOUR=1 wyłącza rozgłaszanie multicast LAN bez zmiany konfiguracji Plugin; akceptowane wartości prawdziwe to 1, true, yes i on (starsza wersja: OPENCLAW_DISABLE_BONJOUR).
• OPENCLAW_DISABLE_BONJOUR=0 wymusza włączenie rozgłaszania multicast LAN, także wewnątrz wykrytych kontenerów; akceptowane wartości fałszywe to 0, false, no i off.
• Gdy Plugin Bonjour jest włączony, a OPENCLAW_DISABLE_BONJOUR nie jest ustawione, Bonjour rozgłasza się na zwykłych hostach i automatycznie wyłącza się wewnątrz wykrytych kontenerów.
• gateway.bind w ~/.openclaw/openclaw.json kontroluje tryb wiązania Gateway.
• OPENCLAW_SSH_PORT zastępuje port SSH, gdy rozgłaszane jest sshPort (starsza wersja: OPENCLAW_SSH_PORT).
• OPENCLAW_TAILNET_DNS publikuje wskazówkę MagicDNS w TXT, gdy włączony jest pełny tryb mDNS (starsza wersja: OPENCLAW_TAILNET_DNS).
• OPENCLAW_CLI_PATH zastępuje rozgłaszaną ścieżkę CLI (starsza wersja: OPENCLAW_CLI_PATH).

​

Powiązana dokumentacja

• Zasady wykrywania i wybór transportu: Wykrywanie
• Parowanie Node + zatwierdzenia: Parowanie Gateway