OpenClaw Skill Scanner Guard 是一款专为 OpenClaw 技能生态设计的供应链安全加固工具，旨在通过自动化扫描机制保护用户技能库免受恶意或高风险代码的侵害。该工具基于 cisco-ai-defense/skill-scanner 实现核心检测能力，结合灵活的拦截策略与隔离机制，为开发者提供从技能安装到日常使用的全流程安全防护。其设计原则强调最小化误报影响，仅对标记为高危或严重级别的风险采取阻断措施，而对中低风险则通过告警提示用户进行人工复核，从而在安全与可用性之间取得平衡。 Skill Scanner Guard 支持多种部署模式，包括手动全量扫描、新技能安装前的预检拦截，以及基于文件变更触发的自动监控。当检测到 ~/.openclaw/skills 目录下的技能发生变动时，系统会立即启动扫描流程，并将存在 High/Critical 级别漏洞的技能自动移至 quarantine 隔离区，防止其被加载执行。同时，所有扫描结果均以结构化报告形式保存，便于后续审计和问题追溯。此外，该方案还集成了对 ClawHub 官方技能市场的支持，允许用户在正式安装前先在临时目录中完成安全评估。 整个系统采用轻量级架构，依赖 uv 构建环境并兼容主流 Linux 发行版。用户可通过简单的 shell 脚本调用各功能模块，无需深入理解底层检测引擎即可快速上手。对于追求更高安全标准的组织或个人而言，Skill Scanner Guard 不仅提升了技能来源的可信度，也为构建可信的 AI 代理运行环境奠定了坚实基础。
核心功能特点
- 基于 YARA 规则的高危技能自动拦截，仅阻止 High/Critical 级别威胁
- 支持手动扫描、增量检测和自动监控三种工作模式
- 具备智能隔离机制，将不合规技能移入独立 quarantine 目录
- 提供详细的 Markdown 格式扫描报告，支持风险分类展示
- 集成 ClawHub 技能市场安装流程，实现 staged 安全安装
- 通过 systemd 用户单元实现后台持续监控，实时响应技能变更
适用场景
在日常开发工作中，每当需要引入新的自定义技能或更新现有技能库时，Skill Scanner Guard 可作为第一道防线发挥作用。例如，开发者从本地文件夹复制一个第三方编写的工具技能到 ~/.openclaw/skills 目录后，若未经过安全检查直接运行，可能因包含后门或敏感操作而引发安全隐患。此时，借助 scan_and_add_skill.sh 脚本对该技能进行前置扫描，系统会自动识别潜在风险并决定是否允许安装——只有通过安全验证的技能才会被正式部署，否则将被隔离处理。 对于频繁使用 ClawHub 获取最新技能的场景，该工具同样适用。通过 clawhub_scan_install.sh 命令下载指定技能包后，Guard 会在 staging 区域完成全面检测，确认无高危问题后再将其复制至主技能路径。这一流程有效避免了直接从不可信源拉取技能带来的不确定性，尤其适合团队协作或多设备同步环境下的统一安全管理。 更进阶的应用是启用自动扫描功能。一旦配置好 systemd 用户服务单元，任何对 skills 目录的文件修改（如 git pull 更新、手动编辑配置文件等）都会触发即时扫描。假如某次更新意外引入了含有恶意逻辑的新版本技能，Guard 将在几秒内发现异常并将其自动隔离，同时生成时间戳命名的 quarantine 子目录供后续分析。这种被动防御机制极大降低了人为疏忽导致的安全事件概率，特别适合长期运行的生产环境或高价值 AI 代理项目。