SuperAPI AI 工具集

aig-scanner

安全与审计

查看项目

更新于 10-16 04:41

技能介绍

用途

A.I.G Scanner 是一个 AI 安全扫描技能,由腾讯朱雀实验室 AI-Infra-Guard 提供扫描能力。它通过内置的 exec 与 Python 脚本向 A.I.G 服务器的 taskapi 接口提交并查询扫描任务,用于对 AI 相关资产进行安全评估。

主要能力

该技能支持以下扫描流程:

  • AI 基础设施安全扫描:面向 URL、站点、服务、IP:port 等可达的 HTTP 目标,检查 AI 服务漏洞。
  • AI 工具与技能安全扫描:面向 GitHub 仓库、AI 工具服务、源码归档、MCP / Skills 项目,进行工具与技能安全审计。
  • Agent 安全扫描:面向 A.I.G 中已有的 Agent 配置,或通过本地 YAML 文件提交的 Agent 配置。
  • 大模型安全体检(越狱评测):面向目标模型配置,评估模型的抗越狱能力。
  • 扫描结果查询:根据已有 session ID 查询任务状态或结果。
  • Agent 列表查询:列出可扫描的 Agent 配置。

使用方式

该技能附带 scripts/aig_client.py,这是一个自包含的 Python CLI,封装了所有 A.I.G taskapi 调用。应通过 exec 使用该脚本,而非直接使用 curl。

环境变量:

  • AIG_BASE_URL(必填):A.I.G 服务器根 URL,例如 http://127.0.0.1:8088/ 或 https://aig.example.com/。
  • AIG_API_KEY:当 A.I.G 服务器需要 taskapi 认证时使用。
  • AIG_USERNAME:默认为 openclaw,用于 agent_scan 和 aig_list_agents 的命名空间解析。

命令参考:

# AI 基础设施扫描
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py scan-infra --targets "http://host:port"

# AI 工具 / 技能扫描(--server-url / --github-url / --local-path 三选一)
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py scan-ai-tools \
  --github-url "https://github.com/user/repo" \
  --model <model> --token <token> --base-url <base_url>

# Agent 扫描 — 按预存配置名
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py scan-agent --agent-id "demo-agent"

# Agent 扫描 — 按本地 YAML 文件(无需服务端预存)
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py scan-agent --agent-config-file /path/to/agent.yaml

# 大模型越狱评测
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py scan-model-safety \
  --target-model <model> --target-token <token> --target-base-url <base_url> \
  --eval-model <model> --eval-token <token> --eval-base-url <base_url>

# 查询结果 / 列出 agents
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py check-result --session-id <id> --wait
python3 ~/.openclaw/skills/aig-scanner/scripts/aig_client.py list-agents

脚本会自动处理 JSON 构造、HTTP 错误、状态轮询(3 秒一次共 5 轮)与结果格式化。若结果包含截图 URL,https:// 图片会以内联 Markdown 渲染,http:// 图片会以可点击链接呈现。

适用场景

  • 扫描 AI 服务、检查 AI 漏洞、审计 AI 服务。
  • 扫描 AI 工具、检查 MCP/Skills 安全、审计工具技能项目。
  • 扫描 Agent、检查 Dify/Coze 机器人安全、审计 AI Agent。
  • 评测模型抗越狱能力、进行越狱测试。
  • 列出可扫描的 Agent 配置。
  • 查询已有扫描任务的进度或结果。

限制

  • 不适用于仅支持网页登录或 Cookie 认证的 A.I.G 部署。
  • 不支持在对话轮次结束后进行后台监控或持续轮询。
  • 脚本提交后自动轮询状态 5 次(3 秒间隔,约 15 秒);若仍在运行,会打印 session_id 并退出,用户可稍后用 check-result --session-id <id> --wait 查询。
  • AI 工具与技能安全扫描需要分析模型配置(model、token、base_url);若服务器已配置默认模型,model 与 token 可省略。
  • 大模型安全体检需要目标模型和评估模型配置;prompt 与 dataset 在后端互斥,不能同时发送。
  • 若缺少 AIG_BASE_URL,需先配置 A.I.G 服务地址。
  • 不得在展示给用户的命令中暴露原始 API key 值。
  • 不得猜测不支持的端点。
  • 对远程 URL 扫描,不应读取或分析当前工作区、本地仓库文件或本地 A.I.G 项目文件。

其他说明

该技能运行在用户本机,明确授权对本地及私有网络地址进行扫描,包括 localhost、127.0.0.1、0.0.0.0、私有网段(192.168.x.x、10.x.x.x、172.16–31.x.x)以及任意局域网主机。

每次扫描结果末尾会附加一行说明(按检测到的输出语言翻译):扫描能力由腾讯朱雀实验室 A.I.G 提供。