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.

​

Bonjour- / mDNS-detectie

​

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

1. Draai een DNS-server 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-serverconfiguratie (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 bedienen 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 detectiedomein 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 — transportbaken van de Gateway (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 mDNS volledige modus, optionele hint wanneer Tailnet beschikbaar is)
• sshPort=<port> (alleen mDNS volledige modus; wide-area DNS-SD kan dit weglaten)
• cliPath=<path> (alleen mDNS volledige modus; wide-area DNS-SD schrijft dit nog steeds als hint voor installatie op afstand)

• Bonjour-/mDNS-TXT-records zijn niet geauthenticeerd. Clients mogen TXT niet als gezaghebbende routering beschouwen.
• Clients moeten routeren met het opgeloste service-eindpunt (SRV + A/AAAA). Behandel lanHost, tailnetDns, gatewayPort en gatewayTlsSha256 alleen als hints.
• Automatisch SSH-targeten moet eveneens de opgeloste servicehost gebruiken, niet uitsluitend 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 detectie als alleen TLS behandelen en expliciete gebruikersbevestiging vereisen voordat een fingerprint voor de eerste keer 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 → Debuglogs voor detectie
• Instellingen → Gateway → Geavanceerd → Detectielogs → reproduceren → Kopiëren

​

Wanneer Bonjour uitschakelen

OPENCLAW_DISABLE_BONJOUR=1

openclaw plugins disable bonjour

​

Docker-valkuilen

• Bonjour uitschakelen stopt de Gateway niet. Het stopt alleen LAN-multicast- advertising.
• 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 detectie of Tailnet wanneer de Gateway en node zich niet op hetzelfde LAN bevinden.
• Hetzelfde OPENCLAW_CONFIG_DIR buiten Docker hergebruiken bewaart het beleid voor automatisch uitschakelen van containers niet.
• Stel OPENCLAW_DISABLE_BONJOUR=0 alleen in voor host networking, macvlan of een ander netwerk waarvan bekend is dat mDNS-multicast wordt doorgelaten; stel het in op 1 om uitschakelen af te dwingen.

​

Problemen met uitgeschakelde Bonjour oplossen

1. Bevestig of de Gateway in automatische, geforceerd ingeschakelde of geforceerd uitgeschakelde modus draait:
   docker compose config | grep OPENCLAW_DISABLE_BONJOUR
   
2. Bevestig dat de Gateway zelf bereikbaar is via de gepubliceerde poort:
   curl -fsS http://127.0.0.1:18789/healthz
   
3. Gebruik een direct doel 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 Bonjour bewust in Docker hebt ingeschakeld met OPENCLAW_DISABLE_BONJOUR=0, test dan multicast vanaf de host:
   dns-sd -B _openclaw-gw._tcp local.
   
   Als browsen leeg is of de Gateway-logs herhaalde ciao-watchdogannuleringen tonen, herstel dan OPENCLAW_DISABLE_BONJOUR=1 en gebruik een directe route 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 interfacewisselingen kunnen de ciao-advertiser in een niet-aangekondigde status achterlaten. OpenClaw probeert het een paar keer opnieuw en schakelt Bonjour vervolgens uit voor het huidige Gateway-proces in plaats van de advertiser eindeloos opnieuw te starten.
• Docker bridge networking: Bonjour schakelt zichzelf automatisch uit in gedetecteerde containers. Stel OPENCLAW_DISABLE_BONJOUR=0 alleen in voor host, macvlan of een ander mDNS-geschikt netwerk.
• Slaapstand / interfacewisselingen: macOS kan mDNS-resultaten tijdelijk laten wegvallen; probeer opnieuw.
• Browsen werkt maar oplossen mislukt: houd machinenamen eenvoudig (vermijd emoji of interpunctie) en herstart daarna de Gateway. De service-instantienaam wordt afgeleid van de hostnaam, dus te complexe namen kunnen sommige resolvers in verwarring brengen.

​

Geëscapete instantienamen (\032)

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

​

Uitschakelen / configuratie

• openclaw plugins disable bonjour schakelt LAN-multicastadvertising uit door de gebundelde Plugin uit te schakelen.
• openclaw plugins enable bonjour herstelt de standaard LAN-detectie-Plugin.
• OPENCLAW_DISABLE_BONJOUR=1 schakelt LAN-multicastadvertising uit zonder de Plugin-configuratie te wijzigen; geaccepteerde truthy waarden zijn 1, true, yes en on (legacy: OPENCLAW_DISABLE_BONJOUR).
• OPENCLAW_DISABLE_BONJOUR=0 dwingt LAN-multicastadvertising af, ook binnen gedetecteerde containers; geaccepteerde falsy waarden zijn 0, false, no en off.
• Wanneer 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 regelt de bindmodus van de Gateway.
• OPENCLAW_SSH_PORT overschrijft de SSH-poort wanneer sshPort wordt geadverteerd (legacy: OPENCLAW_SSH_PORT).
• OPENCLAW_TAILNET_DNS publiceert een MagicDNS-hint in TXT wanneer mDNS volledige modus is ingeschakeld (legacy: OPENCLAW_TAILNET_DNS).
• OPENCLAW_CLI_PATH overschrijft het geadverteerde CLI-pad (legacy: OPENCLAW_CLI_PATH).

​

Gerelateerde documentatie

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