ClawHub 安全扫描架构揭秘ClawScan 如何检测恶意 AI 技能附 VirusTotal 集成原理【免费下载链接】clawhubSkill Plugin Registry for OpenClaw项目地址: https://gitcode.com/gh_mirrors/mo/clawhubClawHub 是 OpenClaw 生态的 Skill Plugin 注册表Skill Plugin Registry。本文揭秘 ClawHub 安全扫描的完整架构自研系统ClawScan如何把每个技能当作面向 Agent 的产物来审计、如何检测恶意 AI 技能以及 VirusTotal 在其中的集成原理——即使你是新手也能看懂一次技能发布从排队到判定的全流程。 一次发布要经过哪些安全扫描你在 ClawHub 发布一个技能或插件后它不会立刻裸奔而是进入异步安全扫描队列。审计状态有 6 种状态含义Pass未发现低于低风险的可见问题Review安装前先阅读发现项发布物仍可能是合法的Warn高风险关注点或警告信号需格外谨慎Malicious不要安装Pending审计尚未完成Error审计无法完成配套还有风险等级Low/Medium/High风险等级回答它有多大权力审计状态回答你该怎么对待这个结果。详细说明见 docs/security-audits.md。 ClawScan 风险分析把技能当作面向 Agent 的产物ClawScan 是 ClawHub 自研的安全审计系统是审计栈的核心。它与传统杀软的思路不同不只看文件签名而是审查技能作为一个给 AI Agent 看的产物是否自洽。它会综合以下信号技能指令与插件元数据instructions、metadata声明的环境变量与权限安装包内的文件清单与安装说明能力信号capability signals与静态扫描信号SkillSpector 静态检测发现项VirusTotal 遥测发布者提供的相关上下文判断的核心问题是coherence一致性名称、简介、元数据、申请的权限和实际内容是否与用户合理预期相符能力强大本身不等于恶意——ClawScan 会追问这项能力是否被披露、是否服务于声明用途、是否与用例匹配。风险分析还以 OWASP Agentic Skills Top 10 为透镜重点覆盖提示词注入、工具滥用、凭据泄露、不安全执行、记忆/上下文投毒、过度代理excessive agency等 AI 技能特有风险。扫描队列与任务调度的核心逻辑位于 convex/securityScan.ts其中静态扫描信号仅作为内部评审上下文不会单独变成公开的拦截判决。⚙️ 扫描流水线如何运转从排队、领取到判定整条流水线是队列 工作进程的经典架构共三步入队发布动作触发扫描请求系统为任务创建securityScanJobs队列条目默认每次任务预留10 分钟等待 VirusTotal 结果convex/securityScan.ts#L36-L37并允许最多 3 次尝试convex/securityScan.ts#L39。领取与物化扫描工作进程 scripts/security/run-codex-scan-worker.ts 通过租约lease token竞争领取任务支持三种扫描对象——技能版本、插件发布物、手动提交的扫描请求scripts/security/run-codex-scan-worker.ts#L28-L51。领取后先把产物文件安全物化到临时目录。判定与入库工作进程依次执行 SkillSpector 静态扫描与 LLM 分析最终状态收敛为clean/suspicious/malicious等结论convex/securityScan.ts#L66-L67LLM 输出的维度化评估由 convex/lib/securityPrompt.ts 解析输出结构受 scripts/security/codex-scan-output.schema.json 约束同时工作进程的日志和错误信息会经过脱敏redaction防止密钥外泄。发现项会带Info/Low/Medium/High/Critical严重度标签低置信度的发现项不会进入公开审计汇总页面只保留有说服力的证据。️ VirusTotal 集成原理多厂商引擎信号如何变成一句话ClawHub 将 VirusTotal 作为审计栈中的**恶意软件遥测telemetry**层——业界公认的文件信誉与恶意扫描标准。集成方式很务实扫描任务在创建时就记下waitForVtUntil截止时间scripts/security/run-codex-scan-worker.ts#L35让风险分析与多厂商引擎结果对齐当厂商引擎计数可用时审计页会把原始计数翻译成普通人能读懂的话例如62/62 家厂商判定该技能为干净或2/64 家标记为恶意没有遥测数据时则明确显示No VirusTotal findings不制造虚假安全感。需要强调的是VirusTotal 只是补充信号尤其擅长命中已知恶意产物它不替代 ClawScan 自身理解 Agent 产物的风险分析。两者的结合正是这套审计栈的设计精髓——传统文件信誉 × AI 技能语义审查。 怎么读你的技能安全审计页每个技能/插件页面都提供完整审计报告路径形如/owner/skills/slug/security-audit它把SkillSpector VirusTotal 风险分析三部分合并展示。安装前建议按顺序看审计状态 → 风险等级 → 发现项 → 所需凭据与权限 → 发布者、版本、下载量与星标等信任信号。如果你是发布者还可以在发布前用 CLI 主动触发扫描clawhub scan命令会把扫描提交到注册表、轮询队列进度并可下载完整报告包实现逻辑见 packages/clawhub/src/cli/commands/scan.ts。 扫描之外的第二道防线发布者滥用信号恶意技能检测之外ClawHub 还持续运行发布者滥用信号扫描专门捕捉统计上不对劲的账号行为例如高安装/下载比High install/download ratio持续下载、安装持平Sustained downloads, flat installs——典型的刷量特征这些信号会按严重度分级Potential ban / On the brink / All flagged进入审核队列超过阈值可触发自动封禁评分逻辑位于 convex/lib/publisherAbuseScoring.ts。 延伸阅读与源码索引审计结果怎么读docs/security-audits.md平台安全与漏洞披露docs/security.md举报、moderation hold 与封禁机制docs/moderation.md扫描队列与任务调度convex/securityScan.ts扫描工作进程物化、SkillSpector、LLM 判定scripts/security/run-codex-scan-worker.tsLLM 评估输出解析convex/lib/securityPrompt.ts发布者滥用评分convex/lib/publisherAbuseScoring.ts数据模型定义convex/schema.ts一句话总结ClawHub 用语义审查ClawScan 文件信誉VirusTotal 静态检测SkillSpector 发布者行为信号四层防线让恶意 AI 技能在到达你的 Agent 之前就被拦截——而你要做的只是安装前多看一眼那行审计状态。【免费下载链接】clawhubSkill Plugin Registry for OpenClaw项目地址: https://gitcode.com/gh_mirrors/mo/clawhub创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考