Skill Scanner Guard

强化 OpenClaw 的技能供应链安全：

• 使用 cisco-ai-defense/skill-scanner 扫描技能
• 仅在发现 High/Critical 风险时阻止安装
• 允许存在 Medium/Low/Info 风险的技能，但会发出警告
• 当 ~/.openclaw/skills 发生变更时自动触发扫描
• 将扫描失败的技能隔离至 ~/.openclaw/skills-quarantine

快速开始

安装 skill-scanner（克隆仓库 + 使用 uv 创建环境）

cd "$HOME/.openclaw/workspace"
# 或你存放代码仓库的其他路径

git clone https://github.com/cisco-ai-defense/skill-scanner
cd skill-scanner
CC=gcc uv sync --all-extras

注意：某些环境中构建 yara-python 时会尝试调用 gcc-12；显式设置 CC=gcc 可避免该问题。

工作流

1) 手动扫描全部用户技能

用户技能存放在：

• ~/.openclaw/skills

执行命令：

$HOME/.openclaw/skills/skill-scanner-guard/scripts/scan_openclaw_skills.sh

输出报告保存至：

• /home/rev/.openclaw/workspace/skill_scans/

2) 安装本地文件夹技能（带扫描门控的复制/克隆流程）

请使用封装脚本，而非直接复制：

$HOME/.openclaw/skills/skill-scanner-guard/scripts/scan_and_add_skill.sh /path/to/skill-dir

策略说明：

• 仅当存在 High/Critical 风险时阻止安装（除非指定 --force 参数）
• 若仅存在 Medium/Low/Info 风险，仍会完成安装，但会打印警告摘要

3) 从 ClawHub 安装技能（带扫描门控的预发布安装流程）

先安装到暂存目录，完成扫描后，仅当通过检查才复制到 ~/.openclaw/skills：

$HOME/.openclaw/skills/skill-scanner-guard/scripts/clawhub_scan_install.sh 
# 可选：指定版本
$HOME/.openclaw/skills/skill-scanner-guard/scripts/clawhub_scan_install.sh  --version 

4) 变更自动扫描 + 自动隔离（systemd 用户级服务单元）

安装 systemd 单元（模板位于 references/ 目录中）：

mkdir -p ~/.config/systemd/user
cp -a "$HOME/.openclaw/skills/skill-scanner-guard/references/openclaw-skill-scan."* ~/.config/systemd/user/

systemctl --user daemon-reload
systemctl --user enable --now openclaw-skill-scan.path

行为说明：

• 任何对 ~/.openclaw/skills/ 目录下的变更都会触发 scripts/auto_scan_user_skills.sh
• 若扫描发现 High/Critical 风险，脚本会将对应技能目录移至： ~/.openclaw/skills-quarantine/-
• 扫描报告写入： /home/rev/.openclaw/workspace/skill_scans/auto/

检查状态：

systemctl --user status openclaw-skill-scan.path
journalctl --user -u openclaw-skill-scan.service -n 100 --no-pager
ls -la ~/.openclaw/skills-quarantine

内置资源

scripts/

• scan_openclaw_skills.sh：为用户技能及内置技能生成 Markdown 格式报告
• scan_and_add_skill.sh：扫描候选技能文件夹；仅当通过检查才安装
• clawhub_scan_install.sh：从 ClawHub 暂存安装、扫描、再正式安装
• auto_scan_user_skills.sh：监听 ~/.openclaw/skills 变更并全量扫描；对 High/Critical 风险技能执行隔离

references/

• openclaw-skill-scan.path / openclaw-skill-scan.service：systemd --user 路径监听单元