#10517: feat: Add Bonjour interface binding config option
gateway
stale
Cluster:
Gateway Resilience and Configuration
# Add Bonjour interface binding configuration
### Problem
On multi-homed systems where multiple network interfaces are active on the same subnet (e.g., Ethernet and Wi-Fi both connected to the same LAN), OpenClaw's Bonjour/mDNS service advertiser registers on
all interfaces simultaneously. This causes continuous name conflicts as each interface attempts to claim the same service name, resulting in repeated warnings in logs:
```
gateway name conflict resolved; newName="<hostname> (OpenClaw) (N)"
```
The counter increments indefinitely as the conflict resolver keeps renaming the service.
### Solution
This PR adds a new configuration option gateway.bonjour.interface that allows binding Bonjour/mDNS advertising to specific network interface(s). The underlying @homebridge/ciao library already supports
interface binding through its MDNSServerOptions.interface parameter.
### Configuration
The new option accepts either a single interface name or an array of interface names:
```json
{
"gateway": {
"bonjour": {
"interface": "en0"
}
}
}
```
or
```json
{
"gateway": {
"bonjour": {
"interface": ["en0", "en1"]
}
}
}
```
Interface names can be specified as:
- Interface names: "en0", "en1", etc.
- IP addresses: "192.168.1.100"
### Changes...
Most Similar PRs
#17257: fix(bonjour): stop mDNS flood on multi-NIC same-LAN setups (#17222)
by yinghaosang · 2026-02-15
66.4%
#3831: fix: ignore mDNS socket errors to prevent gateway crashes
by cici1029 · 2026-01-29
60.1%
#4653: fix(gateway): improve crash resilience for mDNS and network errors
by AyedAlmudarra · 2026-01-30
56.2%
#10991: feat(gateway): add configurable instance name for Control UI title
by Annaxiebot · 2026-02-07
55.6%
#11528: feat(control-ui): configurable page title with hostname default
by Annaxiebot · 2026-02-07
51.5%
#14277: fix(CLI): Use wss for probeUrl, when gateway has tls enabled
by tha80 · 2026-02-11
51.5%
#11098: Support dual-stack custom and LAN gateway binds
by zUZWqEHF · 2026-02-07
51.1%
#19429: Fix/custom bind host validation
by frudas24 · 2026-02-17
50.8%
#9330: [Swarm] [DX]: Improve gateway.bind validation error messag
by swarmagents · 2026-02-05
50.6%
#8745: fix(gateway): respect gateway.port config and --port CLI flag
by revenuestack · 2026-02-04
50.6%