Node Connect 是一个面向 OpenClaw 的连接诊断技能，用于修复 Control UI 浏览器以及原生 Android、iOS、macOS 节点与 Gateway 之间的连接失败。其目标明确：针对一个确切的客户端和一个确切的 Gateway 进行修复，然后用该客户端的新连接来证明修复有效。
用途 该技能覆盖路由、认证、配对、二维码/设置码以及重连等故障环节。它要求先锁定目标环境，再分类客户端，观察失败尝试，最后按不同路径处理并验证。
主要能力
- 锁定目标：记录目标环境/配置、OpenClaw 二进制、配置/状态根目录、Gateway URL/端口和服务，确保状态、配置、日志和进程身份指向同一个 Gateway。
- 分类客户端：根据请求和 Gateway 日志区分 Control UI 浏览器（client=openclaw-control-ui 或 mode=webchat）与原生移动/节点（官方应用显示 Connect、Scan QR 或设置码，日志显示原生客户端或 role=node）。
- 观察失败尝试：通过 openclaw gateway status --deep、openclaw logs --follow --json、openclaw devices list 以及一系列 config get 命令收集信息，并让客户端在日志实时运行时重试一次，关联客户端 ID、模式、平台、地址、认证结果、设备 ID、用户和关闭码。
- 解释首个失败转换：区分无匹配 Gateway 尝试（路由、DNS、TLS、源或代理问题）、认证失败（token_missing、password_missing、mismatch 或 Tailscale 身份失败）、pairing required（路由和认证成功，需批准待处理请求）以及已连接后出现 1006 的情况。
- 证明路由：选择同机、LAN、tailnet 或公共反向代理中的一种拓扑，不混用。浏览器 Control UI 需要 HTTPS 或 localhost 才能获得浏览器设备身份。涉及 Tailscale 时，通过 tailscale status --json 和 tailscale serve status --json 检查实时状态。
- 浏览器 Control UI 路径：先恢复浏览器认证，再查找配对请求。token/密码认证需在 Control UI 设置中输入凭据；优先在 Gateway 主机上使用 openclaw dashboard 进行一次性签名交接；Tailscale Serve 需验证实时路由和转发身份。
- 原生移动/节点路径：通过 openclaw qr --json 检查原生路由，验证 gatewayUrl 和 urlSource。设置码等同于密码，需由操作员从 Control UI → Devices → Pair device 复制，或在代理工具之外的终端运行 openclaw qr --setup-code-only 并直接粘贴到官方应用。
- 配对批准：使用 openclaw devices list、openclaw devices approve --latest（仅预览）和 openclaw devices approve <requestId> 完成精确批准，随后用 openclaw nodes status 确认。
- 关联与完成：在批准前匹配请求、设备/公钥、客户端、模式/角色、平台、地址、用户和重试时间等事实。只有在最终更改后发起的新尝试证明所有适用检查通过时，才宣布成功。
使用方式 该技能以命令行操作为主，涉及 openclaw gateway、openclaw logs、openclaw devices、openclaw config、openclaw qr、openclaw nodes 等命令。操作需通过锁定的目标环境执行，避免使用裸 openclaw 或类似命名的部署。
适用场景 适用于 OpenClaw Control UI 浏览器或原生移动/节点无法连接 Gateway 时的诊断与修复，包括路由、认证、配对、二维码/设置码和重连问题。
限制 资料未提供关于收费、价格、平台支持范围或具体效果保证的信息。技能强调不得将永久密钥放入聊天、日志或 URL，不得通过代理/聊天/工具输出转发设置码或仪表板 JSON。--latest 仅预览当前请求，不能视为批准。