Bonjour-detectie

Documentation Index

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

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

​

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

1. Voer een DNS-server uit op de gateway-host (bereikbaar via Tailnet).
2. Publiceer DNS-SD-records voor _openclaw-gw._tcp onder een toegewezen zone (voorbeeld: openclaw.internal.).
3. Configureer Tailscale split DNS zodat je gekozen domein voor clients (inclusief iOS) via die DNS-server wordt opgelost.

​

Gateway-configuratie (aanbevolen)

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

​

Eenmalige DNS-serverinstallatie (gateway-host)

openclaw dns setup --apply

• alleen op poort 53 te luisteren op de Tailscale-interfaces van de gateway
• je gekozen domein (voorbeeld: openclaw.internal.) te serveren vanuit ~/.openclaw/dns/<domain>.db

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

​

Tailscale-DNS-instellingen

• Voeg een nameserver toe die verwijst naar het tailnet-IP van de gateway (UDP/TCP 53).
• Voeg split DNS toe zodat je ontdekkingsdomein die nameserver gebruikt.

​

Beveiliging van de Gateway-listener (aanbevolen)

• Stel gateway.bind: "tailnet" in ~/.openclaw/openclaw.json in.
• Herstart de Gateway (of herstart de macOS-menubalkapp).

​

Wat adverteert

​

Servicetypen

• _openclaw-gw._tcp - gateway-transportbeacon (gebruikt door macOS-/iOS-/Android-nodes).

​

TXT-sleutels (niet-geheime hints)

• role=gateway
• displayName=<friendly name>
• lanHost=<hostname>.local
• gatewayPort=<port> (Gateway WS + HTTP)
• gatewayTls=1 (alleen wanneer TLS is ingeschakeld)
• gatewayTlsSha256=<sha256> (alleen wanneer TLS is ingeschakeld en de fingerprint beschikbaar is)
• canvasPort=<port> (alleen wanneer de canvas-host is ingeschakeld; momenteel hetzelfde als gatewayPort)
• transport=gateway
• tailnetDns=<magicdns> (alleen volledige mDNS-modus, optionele hint wanneer Tailnet beschikbaar is)
• sshPort=<port> (alleen volledige modus; weggelaten in minimale en uitgeschakelde modi)
• cliPath=<path> (alleen volledige modus; weggelaten in minimale en uitgeschakelde modi)

• Bonjour-/mDNS-TXT-records zijn niet geauthenticeerd. Clients mogen TXT niet behandelen als gezaghebbende routering.
• Clients moeten routeren met het opgeloste service-eindpunt (SRV + A/AAAA). Behandel lanHost, tailnetDns, gatewayPort en gatewayTlsSha256 alleen als hints.
• Automatische SSH-targeting moet eveneens de opgeloste service-host gebruiken, niet alleen TXT-hints.
• TLS-pinning mag nooit toestaan dat een geadverteerde gatewayTlsSha256 een eerder opgeslagen pin overschrijft.
• iOS-/Android-nodes moeten directe verbindingen op basis van ontdekking behandelen als alleen TLS en expliciete gebruikersbevestiging vereisen voordat een eerste fingerprint wordt vertrouwd.

​

Debuggen op macOS

• Instanties browsen:
  dns-sd -B _openclaw-gw._tcp local.
  
• Eén instantie oplossen (vervang <instance>):
  dns-sd -L "<instance>" _openclaw-gw._tcp local.
  

​

Debuggen in Gateway-logs

• 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 ...

​

Debuggen op iOS-node

• Instellingen → Gateway → Geavanceerd → Discovery Debug Logs
• Instellingen → Gateway → Geavanceerd → Discovery Logs → reproduceer → Kopieer

​

Wanneer Bonjour inschakelen

openclaw plugins enable bonjour

​

Wanneer Bonjour uitschakelen

OPENCLAW_DISABLE_BONJOUR=1

openclaw plugins disable bonjour

​

Docker-valkuilen

• Bonjour start automatisch op macOS-hosts en is elders opt-in. Het uitgeschakeld laten stopt de Gateway niet; het slaat alleen LAN-multicastadvertering over.
• Bonjour uitschakelen wijzigt gateway.bind niet; Docker gebruikt nog steeds standaard OPENCLAW_GATEWAY_BIND=lan zodat de gepubliceerde hostpoort kan werken.
• Bonjour uitschakelen schakelt wide-area DNS-SD niet uit. Gebruik wide-area-ontdekking of Tailnet wanneer de Gateway en node zich niet op hetzelfde LAN bevinden.
• Het opnieuw gebruiken van dezelfde OPENCLAW_CONFIG_DIR buiten Docker bewaart het automatische uitschakelbeleid van de container niet.
• Stel OPENCLAW_DISABLE_BONJOUR=0 alleen in voor host networking, macvlan of een ander netwerk waarvan bekend is dat mDNS-multicast erdoorheen komt; stel het in op 1 om geforceerd uit te schakelen.

​

Problemen oplossen met uitgeschakelde Bonjour

1. Controleer of de Gateway draait in automatische, geforceerd ingeschakelde of geforceerd uitgeschakelde modus:
   docker compose config | grep OPENCLAW_DISABLE_BONJOUR
   
2. Controleer of de Gateway zelf bereikbaar is via de gepubliceerde poort:
   curl -fsS http://127.0.0.1:18789/healthz
   
3. Gebruik een direct target wanneer Bonjour is uitgeschakeld:
   • Control UI of lokale tools: http://127.0.0.1:18789
   • LAN-clients: http://<gateway-host>:18789
   • Clients over netwerken heen: Tailnet MagicDNS, Tailnet-IP, SSH-tunnel of wide-area DNS-SD
4. Als je de Bonjour-plugin bewust hebt ingeschakeld in Docker en adverteren hebt geforceerd met OPENCLAW_DISABLE_BONJOUR=0, test multicast vanaf de host:
   dns-sd -B _openclaw-gw._tcp local.
   
   Als browsen leeg is of de Gateway-logs herhaalde ciao-watchdog- annuleringen tonen, herstel dan OPENCLAW_DISABLE_BONJOUR=1 en gebruik een directe of Tailnet-route.

​

Veelvoorkomende foutmodi

• Bonjour gaat niet over netwerken heen: gebruik Tailnet of SSH.
• Multicast geblokkeerd: sommige Wi-Fi-netwerken schakelen mDNS uit.
• Advertiser blijft hangen in probing/announcing: hosts met geblokkeerde multicast, container bridges, WSL of interfacefluctuaties kunnen de ciao-advertiser in een niet-aangekondigde status achterlaten. OpenClaw probeert het een paar keer opnieuw en schakelt daarna Bonjour uit voor het huidige Gateway-proces in plaats van de advertiser eindeloos opnieuw te starten.
• Docker bridge networking: Bonjour schakelt automatisch uit in gedetecteerde containers. Stel OPENCLAW_DISABLE_BONJOUR=0 alleen in voor host, macvlan of een ander mDNS-geschikt netwerk.
• Slaapstand / interfacefluctuaties: macOS kan mDNS-resultaten tijdelijk laten wegvallen; probeer opnieuw.
• Browsen werkt maar oplossen mislukt: houd machinenamen eenvoudig (vermijd emoji’s of interpunctie) en herstart daarna de Gateway. De service-instantienaam wordt afgeleid van de hostnaam, dus te complexe namen kunnen sommige resolvers verwarren.

​

Geëscapete instantienamen (\032)

• Dit is normaal op protocolniveau.
• UI’s moeten decoderen voor weergave (iOS gebruikt BonjourEscapes.decode).

​

Inschakelen / uitschakelen / configuratie

• macOS-hosts starten standaard automatisch de gebundelde LAN-detectie-Plugin.
• openclaw plugins enable bonjour schakelt de gebundelde LAN-detectie-Plugin in op hosts waar deze niet standaard is ingeschakeld.
• openclaw plugins disable bonjour schakelt LAN-multicastadvertising uit door de gebundelde Plugin uit te schakelen.
• OPENCLAW_DISABLE_BONJOUR=1 schakelt LAN-multicastadvertising uit zonder de Plugin-configuratie te wijzigen; geaccepteerde waarheidswaarden zijn 1, true, yes en on (verouderd: OPENCLAW_DISABLE_BONJOUR).
• OPENCLAW_DISABLE_BONJOUR=0 dwingt LAN-multicastadvertising af, ook binnen gedetecteerde containers; geaccepteerde onwaarheidswaarden zijn 0, false, no en off.
• Wanneer de Bonjour-Plugin is ingeschakeld en OPENCLAW_DISABLE_BONJOUR niet is ingesteld, adverteert Bonjour op normale hosts en schakelt het zichzelf automatisch uit binnen gedetecteerde containers.
• gateway.bind in ~/.openclaw/openclaw.json bepaalt de bindmodus van de Gateway.
• OPENCLAW_SSH_PORT overschrijft de SSH-poort wanneer sshPort wordt geadverteerd (verouderd: OPENCLAW_SSH_PORT).
• OPENCLAW_TAILNET_DNS publiceert een MagicDNS-hint in TXT wanneer de volledige mDNS-modus is ingeschakeld (verouderd: OPENCLAW_TAILNET_DNS).
• OPENCLAW_CLI_PATH overschrijft het geadverteerde CLI-pad (verouderd: OPENCLAW_CLI_PATH).

​

Gerelateerde documentatie

• Detectiebeleid en transportselectie: Detectie
• Node-koppeling + goedkeuringen: Gateway-koppeling