适用于 Openclaw 的 skill-guard

一种安装前安全扫描器,通过在部署前检测 Openclaw Skills 中的提示词注入和恶意软件来保护 AI 智能体。

casperzinou
v1.0.0
2026年4月17日
0
703
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install talonforge-skill-guard

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 talonforge-skill-guard。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 skill-guard?

skill-guard 为使用 Openclaw Skills 的开发者提供了一个关键的安全层。虽然标准的杀毒软件会检查恶意软件特征码,但 skill-guard 专注于 AI 特有的威胁,例如提示词注入、数据泄露 URL 以及可能损害智能体完整性的隐藏指令。通过拦截安装过程,它确保只有经过验证的安全内容才能进入您的工作空间。

该工具利用 mcp-scan 的功能来分析 Skill 的实际内容,而不是依赖静态数据库或服务器端检查。它为在 Openclaw 生态系统上构建应用的任何开发者提供了强大的防御机制,确保第三方集成不会导致数据泄露或有害的 AI 行为。通过在客户端运行,它能针对尚未被中央仓库索引的新发布或更新的威胁提供即时保护。

skill-guard 应用场景

  • 从 ClawHub 安装新 Skill 时,确保它们不包含恶意负载。
  • 审计本地 Skill 中是否存在硬编码的 API keys、tokens 或敏感凭据。
  • 防止可能劫持智能体逻辑并忽略先前指令的提示词注入攻击。
  • 在企业 AI 智能体工作流的 CI/CD 流水线中自动执行安全检查。
  • 将可疑代码隔离在临时暂存区,以便在最终部署前进行人工审核。

skill-guard 工作原理

  1. 用户使用 skill-guard 脚本包装器代替标准 CLI 命令来启动安全安装。
  2. Skill 被下载到 /tmp/ 下的隔离暂存目录,以确保在验证前它绝不会触及活跃的 Openclaw Skills 工作空间。
  3. 引擎调用 mcp-scan 对 Skill 的自然语言指令和代码模式进行深度分析。
  4. 如果扫描结果显示安全,Skill 将自动移动到生产工作空间;如果发现威胁,进程将被阻止,且 Skill 将保持隔离状态。

skill-guard 配置指南

要开始使用 Openclaw Skills 的安全安装,请确保您已安装所需的依赖项,并使用 safe-install 脚本:

# 安装所需的 CLIs
npm i -g clawhub
curl -LsSf https://astral.sh/uv/install.sh | sh

# 执行安全安装
./scripts/safe-install.sh <skill-slug>

# 可选:安装特定版本
./scripts/safe-install.sh <skill-slug> --version 1.2.3

skill-guard 数据架构与分类体系

skill-guard 使用暂存到生产的工作流来组织其安全生命周期和元数据:

属性 规范
暂存目录 /tmp/skill-guard-staging/skills/<slug>/
生产路径 ~/.openclaw/workspace/skills/
扫描严重性代码 E004 (提示词注入), E006 (恶意代码), W007 (不安全的凭据)
退出代码 0 (安全/已安装), 1 (系统错误), 2 (发现威胁/已阻止)

skill-guard 高级特性

  • 支持版本特定的扫描,以确保对现有 Openclaw Skills 的更新保持安全且未受污染。
  • 为需要手动检查后绕过警告的高级用户提供强制覆盖功能。
  • 自动隔离管理,将标记的 Skill 存储以供取证分析,且不会威胁到主要智能体环境。
  • 对机器状态篡改尝试和未经授权的第三方内容暴露进行深度检测。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*