用途:诊断 OpenClaw 节点连接与配对失败,覆盖 Android、iOS、macOS 伴侣应用。核心思路是先确定拓扑(同机/模拟器/USB 隧道、同一局域网、同一 Tailscale tailnet、公网 URL/反向代理),再验证 OpenClaw 是否对外通告该路由,最后修复配对与认证。不同拓扑不可混用:本地 Wi-Fi 问题不应改用 Tailscale,除非确实需要远程访问;VPS/远程网关问题不应继续调试 localhost 或局域网 IP。信息不明确时应先询问:预期路由、使用 QR/设置码还是手动主机端口、应用的确切报错文本、openclaw devices list 是否显示待配对请求。
主要能力:提供一组规范检查命令,优先使用 openclaw qr --json(与 Android 扫描的设置码负载一致),并读取 gateway.mode、gateway.bind、gateway.tailscale.mode、gateway.remote.url、gateway.auth.mode、gateway.auth.allowTailscale、plugins.entries.device-pair.config.publicUrl 等配置,以及 openclaw devices list、openclaw nodes status。远程网关时运行 openclaw qr --remote --json;涉及 Tailscale 时运行 tailscale status --json。qr --json 成功时,gatewayUrl 是应用应使用的实际端点,urlSource 说明生效的配置路径。
常见根因:仅绑定 loopback 时远程节点无法连接,需先修路由再生成新设置码;gateway.bind=auto 若有效 QR 路由仍是 loopback 则不够;同局域网用 gateway.bind=lan,同 tailnet 优先 gateway.tailscale.mode=serve 或 gateway.bind=tailnet,公网需设置真实 publicUrl 或 gateway.remote.url。bind=tailnet 但无 tailnet IP 说明主机不在 Tailscale 上;qr --remote 要求 gateway.remote.url 说明远程配置不完整。应用提示 pairing required 表示网络与认证已通,应执行 openclaw devices list 与 openclaw devices approve --latest;提示 bootstrap token 无效或过期需重新生成设置码并重扫;提示 unauthorized 需检查令牌/密码或 Tailscale 预期,Tailscale Serve 时 gateway.auth.allowTailscale 必须匹配。
限制:资料未提供更多平台、版本或收费信息;修复应给出一个明确诊断和一条路由,信号不足时先询问而非猜测。