diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 5c84951fd..46c2c49a0 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "3a73826e28016e4451550555ca847d5be93dad5c",
-  "syncedAt": "2026-04-27T10:35:59.279Z"
+  "sha": "fa468d0c2dd72e49ef55b0219cb8afbd56ec2c13",
+  "syncedAt": "2026-04-27T10:36:18.953Z"
 }
diff --git a/docs/gateway/bonjour.md b/docs/gateway/bonjour.md
index a8c7935c7..d6d260268 100644
--- a/docs/gateway/bonjour.md
+++ b/docs/gateway/bonjour.md
@@ -141,6 +141,12 @@ The Gateway writes a rolling log file (printed on startup as
 - `bonjour: watchdog detected non-announced service ...`
 - `bonjour: disabling advertiser after ... failed restarts ...`
 
+Bonjour uses the system hostname for the advertised `.local` host when it is a
+valid DNS label. If the system hostname contains spaces, underscores, or another
+invalid DNS-label character, OpenClaw falls back to `openclaw.local`. Set
+`OPENCLAW_MDNS_HOSTNAME=<name>` before starting the Gateway when you need an
+explicit host label.
+
 ## Debugging on iOS node
 
 The iOS node uses `NWBrowser` to discover `_openclaw-gw._tcp`.
diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md
index c4c3f996d..0fcb4fea6 100644
--- a/docs/gateway/configuration-reference.md
+++ b/docs/gateway/configuration-reference.md
@@ -649,7 +649,7 @@ Validation and safety notes:
 
 - `minimal` (default): omit `cliPath` + `sshPort` from TXT records.
 - `full`: include `cliPath` + `sshPort`.
-- Hostname defaults to `openclaw`. Override with `OPENCLAW_MDNS_HOSTNAME`.
+- Hostname defaults to the system hostname when it is a valid DNS label, falling back to `openclaw`. Override with `OPENCLAW_MDNS_HOSTNAME`.
 
 ### Wide-area (DNS-SD)