mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-07 19:48:31 +08:00
f7d7148cf0
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green. Closes #100141
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
---
|
|
summary: "CLI reference for `openclaw dns` (wide-area discovery helpers)"
|
|
read_when:
|
|
- You want wide-area discovery (DNS-SD) via Tailscale + CoreDNS
|
|
- You're setting up split DNS for a custom discovery domain (example: openclaw.internal)
|
|
title: "DNS"
|
|
---
|
|
|
|
# `openclaw dns`
|
|
|
|
DNS helpers for wide-area discovery (Tailscale + CoreDNS). Currently macOS + Homebrew CoreDNS only.
|
|
|
|
Related:
|
|
|
|
- Gateway discovery: [Discovery](/gateway/discovery)
|
|
- Wide-area discovery config: [Configuration](/gateway/configuration)
|
|
|
|
## `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
|
|
```
|
|
|
|
| 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
|
|
|
|
## Related
|
|
|
|
- [CLI reference](/cli)
|
|
- [Discovery](/gateway/discovery)
|