node-connection-doctor — OpenClaw节点连接诊断
v1.0.3通过自动检查、错误诊断、CLI指导和一键修复功能，帮助用户快速诊断和解决OpenClaw节点连接失败问题。支持QR/设置码扫描失败、手动配对失败、VPN/Tailscale问题、gateway.bind/gateway.remote.url配置错误等常见场景。
0· 99·0 当前·0 累计
by 安全扫描
OpenClaw
可疑
medium confidence该技能基本实现了其声称的功能（运行OpenClaw CLI检查和可选修复），但在安装前需要了解一些明显的不一致性和敏感行为：缺少声明的依赖项、意外的权限访问、本地配置读取以及引导令牌的打印。
评估建议
在安装或运行此技能前：(1) 验证环境：确保Node.js和OpenClaw CLI已安装并在PATH中——虽然包未声明这些依赖，但脚本需要它们。(2) 在运行修复前备份OpenClaw配置目录。(3) 先使用诊断模式；避免在生产环境中使用auto_confirm/自动运行修复。(4) 注意修复流程会将引导令牌打印到stdout——如果系统收集控制台输出（日志、监控、截图），将这些输出视为敏感信息并避免暴露。(5) 要求作者更正元数据（声明所需二进制文件、澄清不必要的'system:cron'权限）并提供dry-run选项以显示确切命令而不执行（诊断模式部分实现了这一点）。(6) 如需更强保证，请在受控sandbox中运行脚本或限制日志记录，并在执行前本地查看源文件。...详细分析 ▾
⚠ 用途与能力
该技能的代码和文档与其声明的用途（诊断和修复OpenClaw节点连接）一致。然而，包元数据和SKILL.md未声明重要的运行时前提条件：脚本调用'openclaw' CLI并需要Node.js才能运行，但'required binaries'为空，清单也未声明'openclaw' CLI为必需。这种不一致在信任该技能前应予以纠正。
ℹ 指令范围
运行时指令和脚本保持在故障排除范围内（网关状态、设备配对配置、ping/Tailscale检查、重置令牌、重启网关）。注意两点：(1) 修复流程会将新生成的引导令牌打印到stdout（scripts/fix.js记录'Token:'），这对用户很有用，但如果日志被捕获或转发则很敏感；(2) 脚本读取本地配置文件（./config/plugins/entries/device-pair.config.json）并执行shell命令——两者都是为此目的而预期的，但可能暴露secret/配置，应谨慎运行。
✓ 安装机制
没有远程安装脚本或第三方下载；这实际上是包含在包中的指令+脚本捆绑包。与远程下载相比，这降低了供应链风险。没有安装规范，因此不会从任意URL自动获取任何内容。
⚠ 凭证需求
该技能不请求环境变量或外部凭证，这是合理的。但它确实需要（但未声明）Node.js和PATH中的'openclaw' CLI。它还读取可能包含令牌的本地配置文件。代码将引导令牌打印到stdout——对本地配对来说是合理的，但这很敏感，可能被日志或监控捕获；SKILL.md/FAQ声称'does not collect API keys or send configuration to external servers'，这对于包含的代码是准确的，但包还包含营销/文档提及Slack/webhook集成（未实现）和可能需要凭证的自动化发布工作流——这些是带外的，不应与运行时行为混淆。
ℹ 持久化与权限
该技能不请求'always: true'，也不试图持久化自身或修改其他技能。Hook清单列出权限'node:exec'（预期）和'system:cron'（提供的脚本未使用）——cron权限对于包含的代码来说是意外且不必要的，应该被质疑。修复模式可以修改OpenClaw配置并重启服务（需要admin/root），这对于修复工具是合适的，但如果误用或无人值守运行（auto_confirm=true）则会增加影响。
⚠ scripts/diagnose.js:17
检测到Shell命令执行（child_process）。
⚠ scripts/fix.js:27
检测到Shell命令执行（child_process）。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.32026/3/25
node-connection-doctor初始版本发布。自动诊断和修复OpenClaw节点连接问题。支持常见失败场景：QR/设置码错误、手动配对失败、VPN/Tailscale问题和配置错误。提供分步CLI建议并导出诊断报告。包含一键修复选项（重置令牌、重新绑定/重启网关）。添加了英文文档和工作流文件。
● Pending
安装命令
点击复制官方npx clawhub@latest install node-connection-doctor
镜像加速npx clawhub@latest install node-connection-doctor --registry https://cn.longxiaskill.com 镜像可用
技能文档
自动诊断和修复OpenClaw节点连接问题
📋 概述
该技能帮助用户快速诊断和解决OpenClaw节点连接失败问题。涵盖常见场景：
- QR/设置码扫描失败
- 手动连接失败（未授权、引导令牌无效）
- Tailscale/VPN问题
- gateway.bind / gateway.remote.url配置错误
🎯 核心功能
- 自动诊断
openclaw gateway status）
- 验证节点配对配置（plugins.entries.device-pair.config）
- 测试网络连接（ping、Tailscale状态）- 生成修复建议
- 一键修复（可选）
🔧 使用示例
# 诊断节点连接问题
skill: node-connection-doctor
input:
mode: diagnose
verbose: true
# 一键修复（需要确认）
skill: node-connection-doctor
input:
mode: fix
auto_confirm: false
💰 价格
- 单次诊断：$5
- 完整修复服务：$15
- 企业API访问：$50/月
📊 预期价值
- 节省时间：30分钟 → 2分钟
- 减少错误：自动识别20+常见问题
- 成功率：95%的问题可自动修复
🛠️ 技术要求
基于node-connect技能核心逻辑，简化UI，增强错误分类。无外部依赖。离线工作。
技能ID：node-connection-doctor 类别：故障排除 维护：活跃 兼容：OpenClaw v2026.3.23+