安装 / 升级 VT Sentinel 插件

本技能将所有操作委托给官方 openclaw CLI。它不会删除文件、手动编辑 openclaw.json、从外部 URL 下载 tarball，也不会直接操作系统服务。所有文件系统和配置变更均由 openclaw plugins 子命令完成。

本技能将执行的操作

开始前，请向用户明确说明即将运行的具体操作，以便其确认授权：

1. 查询已安装插件（openclaw plugins list）——仅读取操作。
2. 若未安装 → 执行 openclaw plugins install clawhub:openclaw-plugin-vt-sentinel（将经验证的 ClawHub 包下载至 ~/.openclaw/extensions/）。
3. 若已安装 → 执行 openclaw plugins update openclaw-plugin-vt-sentinel（由 OpenClaw CLI 完成原地升级）。
4. openclaw gateway restart —— 重启用户作用域网关，使插件生效。
5. 验证插件是否处于激活状态。

用户数据（vt-sentinel-agent.json、vt-sentinel-state.json、vt-sentinel-audit/）存放在 （位于插件目录之外），在安装/升级过程中保持不变。

来源与可信度

• ClawHub 包：openclaw-plugin-vt-sentinel（已验证 / 经 LLM 审查确认为干净代码）。
• npm 包：openclaw-plugin-vt-sentinel（公开发布，MIT 许可协议）。
• 源码仓库：https://github.com/king-tero/VT-sentinel。

若用户对来源存疑，建议先使用以下命令检查该包：openclaw plugins inspect clawhub:openclaw-plugin-vt-sentinel。

步骤 1：检查当前状态

exec { "command": "openclaw plugins list" }

在输出中查找 openclaw-plugin-vt-sentinel。

• 未出现 → 进入步骤 2（全新安装）。
• 已存在 → 进入步骤 3（原地升级）。

步骤 2：全新安装

exec { "command": "openclaw plugins install clawhub:openclaw-plugin-vt-sentinel" }

该命令将下载 ClawHub 包、注册插件，并自动加载技能与钩子（hook）。无需任何手动配置。完成后进入步骤 4。

步骤 3：原地升级

exec { "command": "openclaw plugins update openclaw-plugin-vt-sentinel" }

OpenClaw CLI 以原子方式处理升级：拉取最新版本、替换扩展目录、更新 plugins.installs 元数据。用户在 plugins.entries 中的配置及 下的状态文件均被保留。

若 CLI 报告“已是最新版本”，请告知用户 VT Sentinel 已为最新版，并跳至步骤 5（仅验证）。

若升级被阻塞（例如因损坏的安装），请回退至使用官方子命令进行干净重装：

exec { "command": "openclaw plugins uninstall openclaw-plugin-vt-sentinel --force" }
exec { "command": "openclaw plugins install clawhub:openclaw-plugin-vt-sentinel" }

uninstall 命令通过单一受支持的操作移除扩展目录并清理 plugins.installs —— 请勿手动编辑 openclaw.json。

步骤 4：重启网关

插件需在网关重启后方可激活。OpenClaw CLI 提供跨平台封装，自动适配底层服务管理器（macOS 使用 launchd，Linux 使用 systemd 用户单元，Windows 使用 schtasks）：

exec { "command": "openclaw gateway restart" }

步骤 5：验证

exec { "command": "openclaw plugins list" }

确认 openclaw-plugin-vt-sentinel 显示为已加载。正常安装应注册9 个工具和2 个钩子。

步骤 6：通知用户

1. VT Sentinel 已成功安装并处于激活状态（请说明本次是全新安装还是升级；如已知，注明升级前版本号）。
2. 无需 API 密钥 —— 插件在首次扫描时自动向 VirusTotal 的 AI API（VTAI）注册。零配置即可使用。
3. 用户可选择自行添加 VirusTotal API 密钥以获得更高调用频率限制：

   openclaw config set plugins.entries.openclaw-plugin-vt-sentinel.config.apiKey "vt_xxxxxxxx"
   

   自 v0.11.0 起，VIRUSTOTAL_API_KEY 环境变量回退机制已被弃用 —— 当前仅支持插件配置项或 VTAI 自动注册两种方式。

VT Sentinel 提供的功能

安装后暴露的工具如下：

• vt_scan_file —— 全文件扫描（传统杀毒引擎 + AI 代码洞察）
• vt_check_hash —— 快速哈希值查询
• vt_upload_consent —— 敏感文件上传前的用户授权流程
• vt_sentinel_status —— 查看当前配置、监控目录及防护状态
• vt_sentinel_configure —— 运行时动态调整设置（预设方案、通知级别、拦截模式）
• vt_sentinel_reset_policy —— 恢复默认策略
• vt_sentinel_help —— 快速入门指南与隐私说明
• vt_sentinel_update —— 检查更新并获取升级指引
• vt_sentinel_re_register —— 重新向 VTAI 注册代理身份

行为特征：

• 自动扫描下载和新建的文件（传统杀毒引擎 + AI 代码洞察）
• 主动拦截已知恶意文件的执行及危险命令模式
• 在 /vt-sentinel-audit/ 下生成轮转式审计日志

故障排查

若任一步骤失败：

• 检查与 ClawHub 及 OpenClaw 网关的连通性：openclaw gateway status。
• 以详细模式重新运行失败命令：在 openclaw plugins ... 命令末尾追加 --verbose 参数。
• 检查插件加载错误：openclaw plugins doctor。
• 安装前检查包内容：openclaw plugins inspect clawhub:openclaw-plugin-vt-sentinel。

约束条件

• 禁止手动修改 ~/.openclaw/openclaw.json —— openclaw plugins install/update/uninstall 命令会以原子方式管理配置。
• 禁止对 ~/.openclaw/extensions/... 执行 rm -rf —— 应改用 openclaw plugins uninstall。
• 若用户报告插件被阻止，请检查其 openclaw.json 中的 plugins.deny 字段（仅允许只读查看；该文件由用户自行编辑）。