SuperAPI AI 工具集

security-audit-2

安全与审计

查看项目

更新于 10-16 07:11

技能介绍

security-audit-2 是一个面向代码库以及 OpenClaw/ClawHub 技能的安全审计工作流,其设计理念是“默认假设敌意、失败即关闭(fail-closed)”。它的目标不是回答“这个技能能否正常工作”,而是回答“这个技能是否可能背叛系统”。

用途方面,该工具用于对代码库和 OpenClaw/ClawHub 技能进行安全层面的审查,重点关注凭证泄露、代码安全缺陷、提示注入、持久化机制、可疑产物和依赖卫生等风险,适合在使用不受信技能前进行静态审计与零信任安装前置校验。

主要能力方面,该技能的脚本组合了多个层次:一是通过 trufflehog 进行密钥与凭证泄露扫描;二是通过 semgrep 自动规则进行静态分析(SAST);三是自定义的敌意仓库审计,涵盖提示注入信号、持久化机制、可疑产物以及依赖卫生。任意一层失败,整体审计结果即判定为 FAIL。

使用方式方面,可在技能文件夹内运行以下命令(使用 bash 以便在 zip 下载未保留可执行位的情况下也可运行):

bash scripts/run_audit_json.sh <path>

示例:

bash scripts/run_audit_json.sh . > /tmp/audit.json jq '.ok, .tools' /tmp/audit.json

该工具支持用户配置严格程度,默认为 standard:

OPENCLAW_AUDIT_LEVEL=standard bash scripts/run_audit_json.sh <path> OPENCLAW_AUDIT_LEVEL=strict bash scripts/run_audit_json.sh <path> OPENCLAW_AUDIT_LEVEL=paranoid bash scripts/run_audit_json.sh <path>

其中 standard 为务实的严格默认值,要求 lockfiles,安装钩子、持久化与提示注入信号会判定为失败;strict 会让更多模式成为硬性 FAIL,例如压缩或混淆产物;paranoid 则不会容忍“尽力而为”的哈希失败,更多情况采取 fail-closed 行为。

在严格或隔离工作流中,要求仓库根目录提供机器可读的意图与权限清单:openclaw-skill.json。如果仓库或技能未提供该清单,敌意审计应将其视为 FAIL。相关说明见 docs/OPENCLAW_SKILL_MANIFEST_SCHEMA.md。

Docker 为可选组件,该技能可以在不使用 Docker 的情况下进行静态审计。如需执行任何生成或不受信的代码,建议在独立的沙箱工作流中进行。

文件构成方面,scripts/run_audit_json.sh 为主 JSON 审计运行器;scripts/hostile_audit.py 为提示注入、持久化与依赖卫生扫描器;scripts/security_audit.sh 为便捷包装脚本(始终返回 JSON,从不返回非零退出码);openclaw-skill.json 为机器可读的意图与权限清单。

适用场景方面,适合在安装或引入 OpenClaw/ClawHub 技能前进行安全审计,也适用于需要对仓库进行敌意假设审查、零信任安装流程以及严格或隔离工作流的场景。

限制方面,资料未提供该工具的具体收费、价格、平台支持范围或效果保证等信息;其 Docker 使用为可选,执行不受信代码需另建沙箱;严格或隔离模式依赖仓库根目录的 openclaw-skill.json 清单,缺失即判定失败。