用途：诊断 OpenClaw 移动端或 macOS 节点连接网关时的配对、二维码/设置码、路由、认证和连接失败问题，目标是找到节点到网关的唯一真实路径，确认 OpenClaw 正在广播该路径，再修复配对与认证。
主要能力：先判断拓扑类型（同机/模拟器/USB 隧道、同一局域网/Wi-Fi、同一 Tailscale 网络、公网 URL/反向代理），避免混用；通过 openclaw qr --json 等命令读取 gatewayUrl 与 urlSource，判断实际生效的路由来源；用配置查询命令检查 gateway.mode、gateway.bind、gateway.tailscale.mode、gateway.remote.url、gateway.auth.mode 等；结合 tailscale status --json、openclaw devices list、openclaw nodes status 定位根因。
使用方式：优先运行 openclaw qr --json（与 Android 扫描的设置码载荷一致）；依次检查相关配置项；如指向远程网关，运行 openclaw qr --remote --json；涉及 Tailscale 时运行 tailscale status --json。若提示需要配对，用 openclaw devices list 与 openclaw devices approve --latest 批准待处理设备；若提示 bootstrap token 无效或过期，重新生成设置码并重新扫描；若提示未授权，检查 token/密码或 Tailscale 预期是否符合 gateway.auth.allowTailscale。
适用场景：同一局域网、Tailscale 网络或公网远程网关下的节点连接排障，以及配对、认证、路由异常的处理。
限制：资料未提供支持的 OpenClaw 具体版本、平台兼容范围、收费与价格信息；若配置或报错信息不明确，应先询问路由意图、是否使用 QR/设置码、准确的应用报错文本以及是否存在待处理配对请求，而不是猜测。