Back to Openclaw

DNS

docs/cli/dns.md

2026.7.11.4 KB
Original Source

openclaw dns

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

Related:

dns setup

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

bash
openclaw dns setup
openclaw dns setup --domain openclaw.internal
openclaw dns setup --apply
OptionEffect
--domain <domain>Wide-area discovery domain (for example openclaw.internal).
--applyInstall/update CoreDNS config and (re)start the service. Requires sudo, macOS only.

Without --domain, OpenClaw uses discovery.wideArea.domain from config.

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