OpenClaw 技能安全扫描器，通过模式检测识别 SKILL.md 文件中的潜在风险与恶意指令，辅助人工审查
说明：
## 核心用法
Security Scanner 是一款面向 OpenClaw 生态的安全审查工具，用于在安装前分析技能文件中的可疑模式。其工作流程为：读取 SKILL.md 的 markdown 指令内容 → 应用正则规则检测危险模式 → 生成四级风险评分（LOW/MEDIUM/HIGH/CRITICAL）并标注具体位置 → 用户人工复核后决定是否安装。
**典型场景**：
– 单文件扫描：`Scan the skill at ~/Downloads/SKILL.md`
– 安装前审查：`Scan this email-automation skill before I install it`
– 批量审计：`Scan all my installed OpenClaw skills`
—
## 显著优点
1. **离线运行**：扫描器本身零网络访问、零依赖、零遥测，纯 JavaScript 实现，可审计开源代码
2. **分层风险体系**：从代码注入（CRITICAL）到文档缺失（LOW），风险分级清晰，输出含具体行号、模式匹配文本与修复建议
3. **可配置白名单**：支持 `.security-scanner-config.json` 自定义可信域名与命令，减少误报对高频操作的干扰
4. **明确的能力边界**：文档反复强调”扫描指令文件而非可执行程序”，避免用户产生虚假安全感
—
## 潜在缺点与局限性
– **高误报率**：设计文档明确承认 WILL flag legitimate patterns —— 反引号 markdown 示例、Base64 教学代码、合法的 npm/pip 安装均可能触发警告
– **无法防御未知威胁**：基于正则的模式匹配无法识别零日漏洞或高级混淆技术
– **最终决策依赖人**：工具只生成报告，不提供 definitive verdict，用户需具备基础安全判断能力
– **扫描范围受限**：仅处理明文 markdown，无法检测加密、编译后的 payload
—
## 适合人群
– 频繁从 ClawHub 安装第三方技能的 OpenClaw 用户
– 企业内需要预审计技能的安全运维人员
– 技能开发者（用于 CI/CD 自检， roadmap 已提及）
—
## 常规风险
1. **过度信任风险**：用户可能因”已扫描”而降低警惕，忽视文档强调的 manual review 要求
2. **供应链风险**：scanner.js 虽声称无依赖，但若用户通过 `git clone` 获取，需验证仓库真实性（未提供签名验证机制）
3. **提示注入盲区**：工具检测技能文件内的可疑指令，但无法防御针对扫描器本身的 prompt engineering 攻击（如技能文档嵌入误导性上下文诱导扫描器忽略风险）
4. **版本滞后风险**：恶意模式库依赖社区贡献，新型攻击手法可能未被及时收录
会员专属
