Diagnostics TLS Installer

OpenClaw Skill/扩展，用于在对话中安装或更新 @volcengine/diagnostics-tls 插件。

设计原则

• 安装能力不内置：安装/配置完全通过调用 @volcengine/diagnostics-tls-install npm 包完成。
• 更新能力可控：更新时优先 openclaw plugins update（clawhub 来源），并与 npm 官方源 latest 对齐；当 clawhub 同步延迟导致版本不一致时，触发兜底重装并恢复配置。

安装与启用

方式一：通过 diagnostics-tls-install 一键安装（推荐）

当你运行 @volcengine/diagnostics-tls-install 完成 @volcengine/diagnostics-tls 安装后，会自动顺带安装并启用本 Skill（@volcengine/diagnostics-tls-skill，插件 id：diagnostics-tls-installer）。

方式二：手动安装

openclaw plugins install "@volcengine/diagnostics-tls-skill" --pin
openclaw plugins enable diagnostics-tls-installer
openclaw gateway restart

联调

• 本地与 OpenClaw 联调（含 watch）：docs/dev-with-openclaw.md

对外工具（OpenClaw Tools）

• diagnostics_tls_install
  • 行为：调用 @volcengine/diagnostics-tls-install 的 CLI（non-interactive）完成安装与 openclaw.json 写入。
• diagnostics_tls_update
  • 行为：
    1. 查询 npm 官方源 @volcengine/diagnostics-tls latest
    2. 执行 openclaw plugins update @volcengine/diagnostics-tls
    3. 如果 update 后版本 != npm latest：
       • 备份卸载前 openclaw.json 的 plugins.entries[diagnostics-tls] 配置（以及 allow）
       • openclaw plugins uninstall diagnostics-tls
       • openclaw plugins install @volcengine/diagnostics-tls@<latest> --pin
       • 把备份的 entries/allow 写回 openclaw.json
       • 返回消息里会明确说明触发了该兜底逻辑
• diagnostics_tls_diagnose
  • 行为：读取 openclaw.json 中 diagnostics-tls 配置，针对指定 logType 调用 TLS 上报接口写入少量测试数据，并分析未上报原因（endpoint/权限/鉴权/网络等）。

开发

pnpm install
pnpm test
pnpm build