@@ -9,9 +9,10 @@ title: "Bonjour discovery"
99# Bonjour / mDNS discovery
10101111OpenClaw uses Bonjour (mDNS / DNS‑SD) to discover an active Gateway (WebSocket endpoint).
12-Multicast `local.` browsing is a **LAN-only convenience**. For cross-network discovery, the
13-same beacon can also be published through a configured wide-area DNS-SD domain. Discovery is
14-still best-effort and does **not** replace SSH or Tailnet-based connectivity.
12+Multicast `local.` browsing is a **LAN-only convenience**. The bundled `bonjour`
13+plugin owns LAN advertising and is enabled by default. For cross-network discovery,
14+the same beacon can also be published through a configured wide-area DNS-SD domain.
15+Discovery is still best-effort and does **not** replace SSH or Tailnet-based connectivity.
15161617## Wide-area Bonjour (Unicast DNS-SD) over Tailscale
1718@@ -79,7 +80,9 @@ For tailnet‑only setups:
79808081## What advertises
818282-Only the Gateway advertises `_openclaw-gw._tcp`.
83+Only the Gateway advertises `_openclaw-gw._tcp`. LAN multicast advertising is
84+provided by the bundled `bonjour` plugin; wide-area DNS-SD publishing remains
85+Gateway-owned.
83868487## Service types
8588@@ -97,7 +100,7 @@ The Gateway advertises small non‑secret hints to make UI flows convenient:
97100- `gatewayTlsSha256=<sha256>` (only when TLS is enabled and fingerprint is available)
98101- `canvasPort=<port>` (only when the canvas host is enabled; currently the same as `gatewayPort`)
99102- `transport=gateway`
100-- `tailnetDns=<magicdns>` (optional hint when Tailnet is available)
103+- `tailnetDns=<magicdns>` (mDNS full mode only, optional hint when Tailnet is available)
101104- `sshPort=<port>` (mDNS full mode only; wide-area DNS-SD may omit it)
102105- `cliPath=<path>` (mDNS full mode only; wide-area DNS-SD still writes it as a remote-install hint)
103106@@ -167,10 +170,12 @@ sequences (e.g. spaces become `\032`).
167170168171## Disabling / configuration
169172170-- `OPENCLAW_DISABLE_BONJOUR=1` disables advertising (legacy: `OPENCLAW_DISABLE_BONJOUR`).
173+- `openclaw plugins disable bonjour` disables LAN multicast advertising by disabling the bundled plugin.
174+- `openclaw plugins enable bonjour` restores the default LAN discovery plugin.
175+- `OPENCLAW_DISABLE_BONJOUR=1` disables LAN multicast advertising without changing plugin config; accepted truthy values are `1`, `true`, `yes`, and `on` (legacy: `OPENCLAW_DISABLE_BONJOUR`).
171176- `gateway.bind` in `~/.openclaw/openclaw.json` controls the Gateway bind mode.
172177- `OPENCLAW_SSH_PORT` overrides the SSH port when `sshPort` is advertised (legacy: `OPENCLAW_SSH_PORT`).
173-- `OPENCLAW_TAILNET_DNS` publishes a MagicDNS hint in TXT (legacy: `OPENCLAW_TAILNET_DNS`).
178+- `OPENCLAW_TAILNET_DNS` publishes a MagicDNS hint in TXT when mDNS full mode is enabled (legacy: `OPENCLAW_TAILNET_DNS`).
174179- `OPENCLAW_CLI_PATH` overrides the advertised CLI path (legacy: `OPENCLAW_CLI_PATH`).
175180176181## Related docs
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。