用途
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 提供。