openclaw-skill-scanner

🔍 OpenClaw技能安全扫描卫士

T2来源A级认证,专注OpenClaw Skill安全扫描,识别恶意代码模式,保障第三方供应链安全。

收藏
18.6k
安装
3.9k
版本
v1.0.0
CLS 安全性认证2026-05-12
点击查看完整报告 >

使用说明

skill-scanner是一款专为OpenClaw生态设计的静态安全扫描工具,旨在解决第三方Skill供应链安全问题。作为T2来源的A级安全认证工具,它通过命令行界面提供多维度恶意代码检测能力,帮助用户在安装前识别潜在威胁。

核心用法方面,该工具支持四种扫描模式:批量扫描已安装Skill、针对特定Skill的深度检查、单文件分析以及关键的预安装扫描。预安装模式尤为实用,它会自动下载目标Skill到临时目录、执行扫描、生成报告并清理现场,实现"下载-扫描-清理"的闭环流程。用户可通过--json参数获取结构化输出,便于集成到自动化流程,而install-hook.sh则提供带确认机制的安全安装包装。

显著优点体现在其架构设计的稳健性。首先,scanner.py仅依赖Python标准库(re、os、subprocess等),零外部依赖消除了供应链投毒风险。其次,检测覆盖11类高危模式,包括Base64隐蔽载荷、管道到Shell攻击、原始IP连接、环境变量窃取、加密挖矿程序等,并配备0-100分的风险评分体系(绿/黄/红三级预警)。此外,whitelist.json机制允许维护已知好/坏Skill列表,配合--force参数强制确认保护,有效防止误操作。

潜在局限在于,作为静态分析器,它可能无法检测高度混淆或创新的恶意代码模式;依赖正则表达式匹配已知特征,对零日攻击或高级持续性威胁(APT)的防御能力有限;且仅针对OpenClaw Skill格式优化,不适用于通用软件安全审计。此外,对于非传统攻击向量(如供应链依赖混淆)的检测能力有待验证。

目标用户群体明确:OpenClaw平台管理员、安全研究人员、以及希望将安全扫描集成到CI/CD流水线的DevOps工程师。对于频繁安装第三方Skill的开发者,这是必备的安全网关工具,也适用于安全合规要求较高的企业环境。

使用风险方面,尽管工具本身安全(无eval/exec危险函数),但需注意:scanner使用subprocess调用openclaw CLI(功能必需但需警惕命令注入),install-hook.sh会实际下载并执行第三方Skill(设计用途但存在中间人攻击风险),且--force参数可绕过安全警告(可能导致恶意代码执行)。建议定期更新whitelist.json,对评分>70的红色风险Skill保持警惕,避免在生产环境直接执行未经验证的Hook脚本,并确保扫描环境网络隔离。

安全解读

核心用法

skill-scanner 是一款面向 ClawHub(OpenClaw/Claude Code)生态的安全扫描工具,提供安装前预检与安装后审计双重防护。核心功能包括:

  • 批量/单技能扫描python3 scanner.py [--skill <name>] 检测已安装技能
  • 预安装安全审查--pre-install <slug> 实现「下载→扫描→报告→清理」完整流程
  • 安全安装钩子install-hook.sh 强制先扫描后安装,支持 --force 覆盖
  • 结构化输出--json 输出便于 CI/CD 集成

检测覆盖 20+ 类威胁:Base64 载荷、管道到 Shell(curl|bash)、原始 IP 直连、危险函数(eval/exec/subprocess)、环境变量外泄、混淆 URL(rentry/pastebin)、加密货币挖矿(xmrig/stratum)、虚假依赖等。采用 0-100 风险评分体系,绿/黄/红三级预警。

显著优点

1. 零依赖安全:纯 Python 标准库实现,无第三方包引入供应链风险
2. 行为透明:仅读取文件执行正则匹配,无网络请求、无系统修改、无数据外泄

3. 功能完整:从静态检测到安装拦截形成闭环,黑白名单机制可自定义

4. CLS 认证:通过 CLS-Certify v2.1.0 全维度扫描,获 A级/78分 评定,六维雷达均达标

5. 合规完备:GDPR、CCPA、数据最小化、用户同意等六项合规全部通过

潜在局限

  • 来源可信度 T3:由 vrtlly.us 个人/社区维护,非企业级安全厂商背书
  • 检测能力边界:基于正则模式匹配,对高级混淆(自定义编码、多态变形)存在绕过可能
  • 依赖社区情报:威胁模式库更新节奏依赖维护者,无自动化情报 feeds
  • CLI 集成风险install-hook.sh 调用 openclaw 子进程,虽属功能必需,但 slug 参数缺乏严格输入验证

适合人群

  • ClawHub/Claude Code 重度用户,需批量审计已安装技能
  • 企业安全团队,希望在技能安装流程中嵌入强制检查点
  • 开源贡献者,研究 LLM 插件生态供应链安全

常规风险

| 风险项 | 说明 |
|--------|------|
| 误报可能 | 合法技能使用 `eval` 等危险函数进行配置解析时可能触发黄灯 |
| 滞后检测 | 新型攻击模式未入库时可能漏报 |
| 脚本权限 | install-hook.sh 需执行权限,若被篡改可劫持安装流程 |

总体评估:作为社区驱动的安全工具,在零依赖、透明行为、闭环流程方面表现优异,适合作为 ClawHub 用户的基线防护层,但建议与官方签名验证、行为沙箱等机制互补使用。

openclaw-skill-scanner 内容

手动下载zip · 14.0 kB
install-hook.shtext/x-shellscript
请选择文件