跳转至

发现

通过 mDNS 和广域 DNS-SD 扫描 Gateway 信标。这是 openclaw gateway 参考文档的一部分。

发现网关(Bonjour)

gateway discover 会扫描 Gateway 信标(_openclaw-gw._tcp)。

  • 多播 DNS-SD:local.
  • 单播 DNS-SD(广域 Bonjour):选择一个域名(例如:openclaw.internal.),并配置 split DNS + 一台 DNS 服务器;参见 Bonjour。

只有启用了 Bonjour 发现(默认)的网关才会广播该信标。

每个信标上的 TXT 提示:role(网关角色提示)、transport(传输提示,例如 gateway)、gatewayPort(WebSocket 端口,通常为 18789)、tailnetDns(MagicDNS 主机名,如可用)、gatewayTls / gatewayTlsSha256(已启用 TLS + 证书指纹)。sshPort 和 cliPath 仅在完整发现模式下发布(discovery.mdns.mode: "full";默认是 "minimal",会省略它们——客户端随后将 SSH 目标默认设为端口 22)。

gateway discover

openclaw gateway discover

<ParamField path="--timeout " type="number" default="2000"> 每条命令的超时时间(浏览/解析)。

--json 布尔值(路径)
机器可读输出(同时禁用样式/加载动画)。

示例:

openclaw gateway discover --timeout 4000
openclaw gateway discover --json | jq '.beacons[].wsUrl'

Note

  • 当启用广域域名时,会扫描 local. 以及已配置的广域域名。
  • JSON 输出中的 wsUrl 派生自已解析的服务端点,而不是仅来自 TXT 提示(例如 lanHost 或 tailnetDns)。
  • discovery.mdns.mode 控制 sshPort/cliPath 在 local. mDNS 和广域 DNS-SD 上的发布(见上文)。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw