openclaw - 💡(How to fix) Fix [Bug]: Bonjour is a mess but it's enabled by default [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#73719Fetched 2026-04-29 06:15:57
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Timeline (top)
labeled ×2closed ×1commented ×1

bonjour prevents openclaw from starting in environments where it isn't used, is enabled by default, anc can't be disabled via the openclaw config file. You have to set an environment variable 'OPENCLAW_DISABLE_BONJOUR=1" because it's special.

Root Cause

bonjour prevents openclaw from starting in environments where it isn't used, is enabled by default, anc can't be disabled via the openclaw config file. You have to set an environment variable 'OPENCLAW_DISABLE_BONJOUR=1" because it's special.

Code Example

10:59:17 [plugins] bonjour: advertised gateway fqdn=raspberrypi (OpenClaw)._openclaw-gw._tcp.local. host=openclaw.local. port=18789 state=unannounced
10:59:17 [openclaw] Unhandled promise rejection: CIAO PROBING CANCELLED
10:59:17 [openclaw] wrote stability bundle: /home/molt/.openclaw/logs/stability/openclaw-stability-2026-04-28T17-59-17-036Z-3894143-unhandled_rejection.json
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

bonjour prevents openclaw from starting in environments where it isn't used, is enabled by default, anc can't be disabled via the openclaw config file. You have to set an environment variable 'OPENCLAW_DISABLE_BONJOUR=1" because it's special.

Steps to reproduce

  1. Start openclaw in an environment that doesn't include mdns
  2. wait 3 minutes while openclaw launches
  3. return to shell prompt because it crashed.

10:59:17 [plugins] bonjour: advertised gateway fqdn=raspberrypi (OpenClaw)._openclaw-gw._tcp.local. host=openclaw.local. port=18789 state=unannounced 10:59:17 [openclaw] Unhandled promise rejection: CIAO PROBING CANCELLED

Expected behavior

If mdns must be enabled by default, it must handle situations where it doesn't work. It should also not be special, openclaw.json should be the single source of configuration.

Actual behavior

openclaw doesn't start successfully, if its run by the service manager it just loops and loops and loops.

OpenClaw version

2026.4.24

Operating system

linux

Install method

install script

Model

irrelevant

Provider / routing chain

irrelevant

Additional provider/model setup details

No response

Logs, screenshots, and evidence

10:59:17 [plugins] bonjour: advertised gateway fqdn=raspberrypi (OpenClaw)._openclaw-gw._tcp.local. host=openclaw.local. port=18789 state=unannounced
10:59:17 [openclaw] Unhandled promise rejection: CIAO PROBING CANCELLED
10:59:17 [openclaw] wrote stability bundle: /home/molt/.openclaw/logs/stability/openclaw-stability-2026-04-28T17-59-17-036Z-3894143-unhandled_rejection.json

Impact and severity

Very annoying and the solution isn't readily available

Additional information

No response

extent analysis

TL;DR

Set the environment variable OPENCLAW_DISABLE_BONJOUR=1 to prevent bonjour from interfering with openclaw startup.

Guidance

  • The issue is caused by bonjour being enabled by default and not being able to be disabled via the openclaw config file.
  • To verify the fix, start openclaw after setting the environment variable and check if it starts successfully.
  • The environment variable can be set using the command export OPENCLAW_DISABLE_BONJOUR=1 before starting openclaw.
  • It is recommended to update the openclaw configuration to allow disabling bonjour via the config file for a more permanent solution.

Example

export OPENCLAW_DISABLE_BONJOUR=1
openclaw

Notes

The provided solution is a temporary workaround, and a more permanent solution would be to update the openclaw configuration to allow disabling bonjour via the config file.

Recommendation

Apply workaround: setting the environment variable OPENCLAW_DISABLE_BONJOUR=1 is the most straightforward solution to prevent bonjour from interfering with openclaw startup.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

If mdns must be enabled by default, it must handle situations where it doesn't work. It should also not be special, openclaw.json should be the single source of configuration.

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING