AIDR-XClaw-Security-Sentinel:面向 AI Agent 的查询与 Skill 安全审计

前言

Agent 会执行用户输入、拉取并运行第三方 Skill,攻击面比传统应用更宽:提示词注入可能改写任务目标,恶意 Skill 可能在安装或执行阶段窃取凭据、改配置。单靠人工审 README 或凭直觉放行,在技能数量上来之后很难持续。

下面介绍 SkillHub 社区技能 AIDR-XClaw-Security-Sentinel(坐标 @user_b163fe4f/aidr-xclaw-security-sentinel,当前版本 2.0.0)。它定位为面向 AI Agent 的企业级安全哨兵:对用户消息做 Query Audit(提示词注入检测),对第三方 Skill 做 Skill Audit(安装或执行前的恶意代码扫描)。官方说明所有 API 调用均需 设备指纹 + API Key 双重认证;SkillHub 标签为 requires_api_key=true。

这是什么

AIDR-XClaw-Security-Sentinel 由社区发布者 user_b163fe4f 维护,分类为 it-ops-security,来源标注为 community。一句话定位:在「处理用户消息」「安装 Skill」「运行 Skill」三类节点上,把安全判断交给统一审计能力,而不是完全依赖 Agent 自身策略。

与「只在本地写几条正则过滤用户输入」相比,它把 用户侧提示词风险 与 Skill 供应链风险 拆成两条审计线,并依赖远端服务完成检测(因此需要 API Key 与设备指纹)。

核心功能

以下能力均来自 SkillHub 与官方简介,未在公开页面展开实现细节的部分不展开臆测。

Query Audit(查询审计)

在用户消息进入 Agent 主流程前或并行审计,用于识别 提示词注入(prompt injection) 类攻击。适用时机:官方写明在处理 user messages 时使用。

Skill Audit(技能审计)

在第三方 Skill 安装前 或 执行前,扫描是否存在 恶意代码 风险。适用时机:安装 skills、运行 skills。

认证与调用约束

官方要求:所有 API 调用 均需 device fingerprint + API key 双重认证。未在已抓取页面中列出具体环境变量名、请求路径或 SDK 示例时,部署侧应以安装后 Skill 包内说明(如 SKILL.md)及发布者文档为准。

安装与启用

SkillHub 页面给出的安装指引是:按 SkillHub 安装与优先源配置 安装坐标 @user_b163fe4f/aidr-xclaw-security-sentinel。CLI 方式如下(安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 且可能不被识别)。

1、确认本机是否已有 skillhub CLI:

command -v skillhub && skillhub --version

2、若未安装,可按 SkillHub 文档执行完整安装或仅 CLI(沙箱限网时需允许联网):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

3、将本 Skill 安装到对应客户端的 skills 目录。以 Cursor 为例,常用路径为 ~/.cursor/skills/:

skillhub install @user_b163fe4f/aidr-xclaw-security-sentinel --dir ~/.cursor/skills/

其他客户端路径(摘自 SkillHub 安装文档,便于对照):Claude Code 为 ~/.claude/skills/;Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。不同 Agent 目录不同,安装前以当前环境为准。

安装完成后,按各 Agent 惯例可能需要重启或重新加载 skills;启用本 Skill 前需准备 API Key 并完成 设备指纹 相关配置(具体字段以 Skill 包内说明为准)。

典型用法

公开 SkillHub 页面未提供独立的 HTTP 示例或配置文件片段,可复现的步骤主要是 通过 SkillHub 安装并在三类时机挂载审计:

  1. 处理用户消息时:在将用户输入交给模型或工具链之前,触发 Query Audit,对提示词注入风险做判定。
  2. 安装 Skill 前:对待安装的第三方 Skill 执行 Skill Audit,再决定是否写入 skills 目录。
  3. 运行 Skill 前:对即将执行的 Skill 再次或首次执行 Skill Audit(以 Skill 内 workflow 为准)。

也可将下列提示交给支持 Skill 安装的 AI 客户端,让其按官方安装文档完成安装(与 SkillHub 页面展示一致):

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_b163fe4f/aidr-xclaw-security-sentinel`。

适用场景与注意

适合谁:在 OpenClaw 系或通用 Agent 工作流中需要统一安全闸门的团队;频繁从 SkillHub 等渠道安装社区 Skill、又希望降低供应链风险的场景。

使用前提:必须能配置 API Key 与 设备指纹,并接受审计请求走外部服务(简介未说明离线模式)。

数据与版本:SkillHub 当前展示版本 2.0.0;评分 100000,下载 637 次,安装数页面显示为 0(以页面统计为准,会随时间变化)。用户线索中的下载次数与页面不一致时,以 SkillHub 页面为准。

限制:已抓取资料未包含 Query Audit / Skill Audit 的阈值策略、误报处理、与具体 Agent 的 hook 点列表;集成深度取决于 Skill 包内 SKILL.md 与 Agent 对 Skill 的加载方式。无法访问 API 或未完成双重认证时,不应假设审计仍会生效。

结尾

AIDR-XClaw-Security-Sentinel 把 用户消息上的提示词注入检测 与 Skill 安装/执行前的恶意代码扫描 收拢到同一安全哨兵角色,并通过 设备指纹 + API Key 约束 API 使用面。若你的 Agent 已接 SkillHub 生态,可从标准坐标安装并在消息处理与 Skill 生命周期关键步骤挂上审计。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_b163fe4f/aidr-xclaw-security-sentinel
  • 安装说明:https://skillhub.cn/install/skillhub.md
  • 坐标:@user_b163fe4f/aidr-xclaw-security-sentinel
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜