openclaw/docs/cli/dns.md
Vincent Koc efefa622e2
docs: fix 20 link defects confirmed live in the verified backlog (#144133)
Mis-pointed targets where a correct target exists, first mentions of
documented surfaces that were never linked, and pages with no Related
section at all. Adds 57 internal links, none broken.

These sat in the ledger's verified bucket, which an earlier round did not
have in scope when it reported this category closed.

Co-authored-by: Vincent Koc <vincent@openclaw.org>
2026-09-11 03:48:10 +08:00

1.9 KiB

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). openclaw dns setup prints its plan on any platform; applying that plan with --apply requires macOS with Homebrew CoreDNS.

Related:

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