Skip to content

Feature Request: Option to disable mDNS/Bonjour (critical for Android/Termux) #28174

@eros-plusval

Description

@eros-plusval

Environment

  • OpenClaw 2026.2.26
  • Android 15 (Samsung Galaxy Fold 7)
  • Termux, Node v24.13.0

Problem

The Bonjour/mDNS watchdog spams the console every ~60 seconds with:

[bonjour] watchdog detected non-announced service; attempting re-advertise (gateway fqdn=localhost (OpenClaw)._openclaw-gw._tcp.local. host=openclaw.local. port=18789 state=probing)

On Android/Termux, mDNS never successfully advertises (no multicast support), creating an infinite retry loop.

More critically, this same module causes gateway crashes when WiFi drops — the mDNS AssertionError kills the Node process entirely.

Requested

A config option like gateway.mdns.enabled: false (or gateway.bonjour.enabled: false) to completely disable mDNS discovery on platforms where it does not work.

Impact

  • Log spam: Console filled with red [bonjour] warnings every minute (cosmetic but noisy)
  • Crash on WiFi drop: mDNS throws unhandled AssertionError when WiFi disconnects, killing the gateway process. This is a real stability issue for mobile/Android deployments.

Workaround

None currently. The only mitigation is restarting the gateway after WiFi drops.

Suggested Implementation

{
  "gateway": {
    "mdns": {
      "enabled": false
    }
  }
}

This would allow users on platforms without proper multicast/mDNS support to skip initialization entirely.

Metadata

Metadata

Assignees

No one assigned

    Labels

    staleMarked as stale due to inactivity

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions