raini-skill-audit

核心用法

Skill Audit 是一款专为 OpenClaw 生态设计的安全扫描工具，提供安装前预检和安装后审计两种模式。用户可通过 /skill-audit scan 命令扫描本地已安装 skill，或使用 /skill-audit check 在安装前审查 ClawHub 上的 skill。工具内置三级检测规则：Critical（读取凭证、外发数据、代码执行）、Warning（非知名域名请求、文件遍历、动态导入）、Info（shell 命令、外部文件读写），最终输出结构化的风险评分报告。

显著优点

1. 零依赖设计：仅使用 Node.js 内置 fs/path 模块，彻底消除第三方依赖带来的供应链风险
2. 检测规则透明：所有风险模式公开可查，无黑盒判断逻辑
3. 只读安全扫描：扫描过程不修改任何目标文件，确保被测 skill 完整性
4. 边界控制完善：自动排除 node_modules/.git，限制文件扩展名白名单，防止目录遍历滥用
5. 场景覆盖完整：同时支持本地目录扫描、已安装 skill 批量审计、远程 skill 预检三种场景

潜在缺点与局限性

1. 静态分析局限：无法检测混淆/加密代码、二进制可执行文件、运行时动态加载的威胁
2. 规则更新依赖：新型攻击模式需等待工具更新检测规则，存在检测滞后窗口
3. 误报可能性：Base64 字符串检测等规则可能将合法混淆代码标记为可疑
4. 无深度语义分析：基于正则匹配而非 AST 解析，对复杂代码结构的判断能力有限
5. T3 来源信任成本：个人开发者维护，长期更新承诺存在不确定性

适合的目标群体

• OpenClaw 重度用户：频繁安装第三方 skill 的开发者或团队
• 安全敏感场景：企业内网部署、处理商业机密的工作环境
• Skill 开发者：发布前自检，提升作品可信度
• 运维/安全团队：作为 skill 供应链治理的自动化入口工具

使用风险

1. 扫描范围风险：若路径参数错误，可能意外扫描非目标目录导致信息泄露
2. 结果解读风险：Critical 标记需人工复核，直接阻断可能误伤合法 skill
3. 性能瓶颈：大规模 skill 仓库的全量扫描可能产生 I/O 压力
4. 安全幻觉：通过扫描不等于绝对安全，不能替代专业渗透测试

核心用法

Skill Audit 是一款专为 OpenClaw 生态设计的防御性安全审计工具，用于扫描已安装或待安装 skill 中的潜在安全威胁。用户可通过 CLI 命令执行两类核心操作：

• /skill-audit scan [skill-name]：扫描本地已安装的 skill，支持指定单个 skill 或批量扫描全部
• /skill-audit check <clawhub-slug>：在从 ClawHub 安装前进行远程预检

工具内置三级风险检测规则：

• 🔴 高风险（Critical）：凭证文件读取、数据外发至未知 URL、eval/exec 代码执行、环境变量密钥读取
• 🟠 中风险（Warning）：非知名域名请求、文件系统遍历、动态 require/import、Base64 混淆
• 🟡 低风险（Info）：shell 命令使用、越目录文件读写、大量依赖包

输出采用结构化报告格式，包含风险评分、文件级定位、严重程度分级及明确的行动建议。

显著优点

1. 零依赖安全设计：仅使用 Node.js 内置模块（fs, path），无外部依赖，从根本上消除供应链攻击面
2. 来源高度可信：来自 OpenClaw 官方技能仓库，维护者为可信组织成员（T2 级别），MIT 开源协议
3. 静态分析能力强：基于正则表达式的多维度模式匹配，覆盖主流恶意代码特征
4. CLI 直接可用：无需复杂配置，agent 可直接调用审计脚本，适合 CI/CD 集成
5. 合规全面通过：满足 GDPR 数据最小化、无敏感数据硬编码、无动态执行、权限匹配等六项合规检查

潜在缺点与局限性

• 误报风险：检测规则（如 webhook URL 模式）在静态扫描时可能被其他工具误识别为实际威胁
• 规则维护成本：安全威胁模式演变迅速，当前硬编码规则需随版本更新，暂不支持热更新
• 性能边界：缺乏扫描深度和文件大小限制配置，处理大型 skill 时可能存在资源消耗问题
• 输出格式局限：当前主要为终端友好格式，JSON/XML 等机器可读格式支持待完善

适合人群

• OpenClaw 生态开发者：需要审查自己或第三方 skill 的安全风险
• 企业安全团队：希望在 CI/CD 流程中集成自动化供应链安全检测
• 安全研究人员：研究 LLM 插件/技能供应链攻击的防御方案
• 谨慎的最终用户：在安装 skill 前希望获得独立安全评估

常规风险

| 风险类型 | 评估 | 说明 |

|---------|------|------|

| 恶意代码 | 极低 | 代码功能与声明完全一致，无实际网络外泄或代码执行 |

| 数据收集 | 极低 | 仅扫描技能代码，不收集用户隐私数据 |

| 供应链攻击 | 极低 | 零外部依赖，无 npm 包引入风险 |

| 权限滥用 | 极低 | 所需权限与审计功能严格匹配 |

| 误用风险 | 低 | 检测规则可能被误解为威胁，需配合语义分析 |

---

安全认证结果：S+ 级（顶级），综合评分 98/100，六项雷达扫描全部通过。