CLI commands

DNS

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 setupopenclaw dns setup --domain openclaw.internalopenclaw 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.

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
Was this useful?
On this page

On this page