SuperAPI AI 工具集

node-connect

通用与其它

查看项目

更新于 10-16 09:59

技能介绍

用途:诊断 OpenClaw 节点连接与配对故障,适用于扫码、安装码或手动连接失败,以及本地 Wi-Fi、Tailscale、公网/反向代理等场景。先确定拓扑(同机/模拟器/USB、同一局域网、同一 tailnet、公网 URL),不要混用。若信息含糊,先询问预期路由、用的是扫码还是手动主机端口、应用的确切报错文本、openclaw devices list 是否有待配对请求,不要凭“连不上”猜测。

主要能力与用法:优先运行 openclaw qr --json,它与 Android 扫描的安装码负载一致;再结合以下命令读取实际配置与状态: openclaw config get gateway.mode openclaw config get gateway.bind openclaw config get gateway.tailscale.mode openclaw config get gateway.remote.url openclaw config get gateway.auth.mode openclaw config get gateway.auth.allowTailscale openclaw config get plugins.entries.device-pair.config.publicUrl openclaw qr --json openclaw devices list openclaw nodes status 若指向远程网关,另运行 openclaw qr --remote --json;涉及 Tailscale 时运行 tailscale status --json。

判读:qr --json 的 gatewayUrl 是应用应使用的实际端点,urlSource 表明生效的配置来源(gateway.bind=lan 为同一局域网;gateway.bind=tailnet 为 tailnet;gateway.tailscale.mode=serve 或 funnel 为 Tailscale 路由;publicUrl 为公网/反代;gateway.remote.url 为远程网关)。若提示仅绑定回环,远程节点无法连接,需先改路由再生成新安装码;同局域网用 gateway.bind=lan;同 tailnet 优先 serve 或 bind=tailnet;公网需设置真实 publicUrl 或 remote.url。若 bind=tailnet 却找不到 tailnet IP,说明主机未真正接入 Tailscale。提示 pairing required 时说明网络与鉴权已通,应执行 openclaw devices list 与 openclaw devices approve --latest。bootstrap token 无效/过期说明安装码过期,任何 URL/鉴权修复后都应重新生成并重扫。unauthorized 表示 token/密码错误或 Tailscale 预期不符,Tailscale Serve 场景需 gateway.auth.allowTailscale 匹配,否则用显式 token/密码。

限制:资料未提供平台、费用、版本或更多安装方式信息;输出一次具体诊断和一条路由,信号不足时应索取信息而非猜测。