Bonjour / mDNS-discovery¶

OpenClaw bruger Bonjour (mDNS / DNS-SD) som en LAN-only bekvemmelighed for at opdage en aktiv Gateway (WebSocket endepunkt). Det er bedst og erstatter ikke SSH eller Tailnet-baseret tilslutning.

Wide‑area Bonjour (Unicast DNS‑SD) over Tailscale¶

Hvis indholdselementet og gateway er på forskellige netværk, vil multicast mDNS ikke krydse grænsen. Du kan holde den samme opdagelse UX ved at skifte til unicast DNS-SD ("Wide-Area Bonjour") over Tailscale.

Overordnede trin:

1. Kør en DNS-server på gateway-værten (tilgængelig over Tailnet).
2. Udgiv DNS‑SD-poster for _openclaw-gw._tcp under en dedikeret zone (eksempel: openclaw.internal.).
3. Konfigurer Tailscale split DNS, så dit valgte domæne resolver via den DNS-server for klienter (inklusive iOS).

OpenClaw understøtter enhver opdagelse domæne; openclaw.internal. er blot et eksempel. iOS/Android-knudepunkter gennemse både local. og dit konfigurerede bredområde-domæne.

Gateway-konfiguration (anbefalet)¶

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

Engangsopsætning af DNS-server (gateway-vært)¶

openclaw dns setup --apply

Dette installerer CoreDNS og konfigurerer den til at:

• lytte på port 53 kun på gatewayens Tailscale-interfaces
• servere dit valgte domæne (eksempel: openclaw.internal.) fra ~/.openclaw/dns/<domain>.db

Validér fra en tailnet-tilsluttet maskine:

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

Tailscale DNS-indstillinger¶

I Tailscale-administrationskonsollen:

• Tilføj en navneserver, der peger på gatewayens tailnet-IP (UDP/TCP 53).
• Tilføj split DNS, så dit discovery-domæne bruger den navneserver.

Når klienter accepterer tailnet-DNS, kan iOS-noder browse _openclaw-gw._tcp i dit discovery-domæne uden multicast.

Gateway-lytterens sikkerhed (anbefalet)¶

Porten Gateway WS (standard 18789) binder til loopback som standard. For adgang til LAN/tailnet , skal du binde dig eksplicit og holde auth aktiveret.

For tailnet‑kun opsætninger:

• Sæt gateway.bind: "tailnet" i ~/.openclaw/openclaw.json.
• Genstart Gateway (eller genstart macOS-menulinjeappen).

Hvad annoncerer¶

Kun Gatewayen annoncerer _openclaw-gw._tcp.

Servicetyper¶

• _openclaw-gw._tcp — gateway-transportbeacon (bruges af macOS/iOS/Android-noder).

TXT-nøgler (ikke‑hemmelige hints)¶

Gatewayen annoncerer små, ikke‑hemmelige hints for at gøre UI‑flows bekvemme:

• role=gateway
• displayName=<friendly name>
• lanHost=<hostname>.local
• gatewayPort=<port> (Gateway WS + HTTP)
• gatewayTls=1 (kun når TLS er aktiveret)
• gatewayTlsSha256=<sha256> (kun når TLS er aktiveret og fingerprint er tilgængeligt)
• canvasPort=<port> (kun når canvas-værten er aktiveret; standard 18793)
• sshPort=<port> (standard er 22, når den ikke er tilsidesat)
• transport=gateway
• cliPath=<path> (valgfri; absolut sti til et kørbart openclaw entrypoint)
• tailnetDns=<magicdns> (valgfrit hint, når Tailnet er tilgængeligt)

Fejlfinding på macOS¶

Nyttige indbyggede værktøjer:

• Browse instanser:

bash dns-sd -B _openclaw-gw._tcp local.

• Resolve én instans (erstat <instance>):

bash dns-sd -L "<instance>" _openclaw-gw._tcp local.

Hvis browsing virker, men resolve fejler, rammer du typisk en LAN‑politik eller et mDNS-resolverproblem.

Fejlfinding i Gateway-logs¶

Gateway skriver en rullende logfil (trykt ved opstart som gateway logfil: ...). Kig efter bonjour: linjer, især:

• bonjour: advertise failed ...
• bonjour: ... name conflict resolved / hostname conflict resolved
• bonjour: watchdog detected non-announced service ...

Fejlfinding på iOS-node¶

iOS-noden bruger NWBrowser til at opdage _openclaw-gw._tcp.

Sådan indsamler du logs:

• Indstillinger → Gateway → Avanceret → Discovery Debug Logs
• Indstillinger → Gateway → Avanceret → Discovery Logs → reproducer → Kopiér

Loggen indeholder tilstandsskift for browseren og ændringer i resultatsættet.

Almindelige fejltilstande¶

• Bonjour krydser ikke netværk: brug Tailnet eller SSH.
• Multicast blokeret: nogle Wi‑Fi-netværk deaktiverer mDNS.
• Sleep / interface-churn: macOS kan midlertidigt miste mDNS‑resultater; prøv igen.
• **Gennemse virker, men løs fejl **: Hold maskinenavne enkle (undgå emojis eller tegnsætning), og genstart derefter Gateway. Tjenesten instans navn stammer fra værten navn, så alt for komplekse navne kan forvirre nogle resolvers.

Escapede instansnavne (\032)¶

Bonjour/DNS-SD undslipper ofte bytes i service instans navne som decimal \DDD sekvenser (f.eks. mellemrum bliver \032).

• Dette er normalt på protokolniveau.
• UI’er bør afkode til visning (iOS bruger BonjourEscapes.decode).

Deaktivering / konfiguration¶

• OPENCLAW_DISABLE_BONJOUR=1 deaktiverer annoncering (legacy: OPENCLAW_DISABLE_BONJOUR).
• gateway.bind i ~/.openclaw/openclaw.json styrer Gatewayens bind-tilstand.
• OPENCLAW_SSH_PORT tilsidesætter SSH-porten, der annonceres i TXT (legacy: OPENCLAW_SSH_PORT).
• OPENCLAW_TAILNET_DNS udgiver et MagicDNS-hint i TXT (legacy: OPENCLAW_TAILNET_DNS).
• OPENCLAW_CLI_PATH tilsidesætter den annoncerede CLI-sti (legacy: OPENCLAW_CLI_PATH).

Relaterede dokumenter¶

• Discovery-politik og transportvalg: Discovery
• Node-parring + godkendelser: Gateway pairing