openclaw/docs/cli/dns.md

summary, read_when, title

summary	read_when	title
CLI reference for `openclaw dns` (wide-area discovery helpers)	You want wide-area discovery (DNS-SD) via Tailscale + CoreDNS You're setting up split DNS for a custom discovery domain (example openclaw.internal)	DNS

openclaw dns

DNS helpers for wide-area discovery (Tailscale + CoreDNS). Currently macOS + Homebrew CoreDNS only.

Related:

• Gateway discovery: Discovery
• Wide-area discovery config: Configuration

dns setup

Plan or apply CoreDNS setup for unicast DNS-SD discovery.

openclaw dns setup
openclaw dns setup --domain openclaw.internal
openclaw dns setup --apply

Option	Effect
--domain <domain>	Wide-area discovery domain (for example openclaw.internal).
--apply	Install/update CoreDNS config and (re)start the service. Requires sudo, macOS only.

Without --domain, OpenClaw uses discovery.wideArea.domain from config. Setting that domain enables wide-area discovery.

Without --apply, the command only prints:

• Resolved discovery domain and zone file path
• Current tailnet IPs
• Recommended openclaw.json discovery config
• Tailscale Split DNS nameserver/domain values to set in the Tailscale admin console

With --apply (macOS only, requires Homebrew CoreDNS):

• Bootstraps the zone file if missing
• Adds the CoreDNS import stanza if missing
• Restarts the coredns brew service

Related

• CLI reference
• Discovery