CLI dns 命令

openclaw dns 提供广域发现（Wide-Area Discovery）的 DNS 辅助工具，基于 Tailscale + CoreDNS 实现。当前仅支持 macOS + Homebrew CoreDNS。

dns setup 命令

规划或应用 CoreDNS 配置，用于单播 DNS-SD 发现：

openclaw dns setup                              # 仅规划，打印推荐配置
openclaw dns setup --domain openclaw.internal   # 指定发现域名
openclaw dns setup --apply                      # 实际安装/更新配置（需要 sudo，仅 macOS）

选项

• --domain <domain>：广域发现域名，如 openclaw.internal；省略时使用配置中的 discovery.wideArea.domain
• --apply：安装或更新 CoreDNS 配置并重启服务

输出内容

不带 --apply 时，命令输出：

• 解析后的发现域名
• zone 文件路径
• 当前 tailnet IP 列表
• 推荐的 openclaw.json discovery 配置片段
• Tailscale Split DNS 需要设置的 nameserver/domain 值

—apply 行为

• 仅支持 macOS，依赖 Homebrew CoreDNS
• 按需初始化 zone 文件
• 确保 CoreDNS import stanza 存在
• 重启 coredns brew service

使用场景

• 跨网络（Tailscale 网络）的 OpenClaw Gateway 发现
• 为自定义域名（如 openclaw.internal）配置 Split DNS

相关链接

• docs/gateway/discovery — Gateway 发现机制
• docs/gateway/configuration — Gateway 配置参考