openclaw/docs/cli/dns.md

1.4 KiB
Raw Blame History

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

openclaw dns

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

Related:

Setup

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

dns setup

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

Options:

  • --domain <domain>: wide-area discovery domain (for example openclaw.internal)
  • --apply: install or update CoreDNS config and restart the service (requires sudo; macOS only)

What it shows:

  • resolved discovery domain
  • zone file path
  • current tailnet IPs
  • recommended openclaw.json discovery config
  • the Tailscale Split DNS nameserver/domain values to set

Notes:

  • Without --apply, the command is a planning helper only and prints the recommended setup.
  • If --domain is omitted, OpenClaw uses discovery.wideArea.domain from config.
  • --apply currently supports macOS only and expects Homebrew CoreDNS.
  • --apply bootstraps the zone file if needed, ensures the CoreDNS import stanza exists, and restarts the coredns brew service.