agent-audit

一键审计本机 AI Agent 环境：供应链投毒 / 密钥暴露 / 端口暴露 / MCP server 体检。 运行时零依赖，全程只读，Windows 优先（同时支持 Linux/macOS）。

为什么需要它（2026 实战背景）

• ClawHavoc 供应链投毒：800+ 恶意 skill 泛滥（2026-02 顶峰）；Snyk 审计 ClawHub 3984 技能中 13.4% 含严重安全问题，36.8% 有漏洞。市场导入 skill 拥有与用户同等的执行权限（terminal / file / web）。
• 端口暴露：OpenClaw 默认监听 0.0.0.0:18789，国家应急中心通报 85% 实例暴露公网；ComfyUI 1000+ 暴露实例被组僵尸网络挖矿。
• 窃密木马：Vidar 变种专偷 agent 配置目录（token / private key）。
• 依赖投毒：2026-03 LiteLLM / Axios / Apifox / Trivy 投毒波及多个 agent 应用。
• MCP 攻击面：MCP 已成 agent 连接工具数据的事实标准，远程 / 无鉴权 / 未知名 npm 包 MCP server 是新入口（对照 OWASP MCP Security Guide）。

快速开始

pip install agent-env-audit     # PyPI（发行版即将上线；import 包名为 agent_audit）
# 或从源码安装
pip install git+https://github.com/mo9652962-ai/agent-audit.git
# 或免安装直接跑
git clone https://github.com/mo9652962-ai/agent-audit.git && cd agent-audit
PYTHONPATH=src python -m agent_audit

agent-audit                     # 默认审计 Hermes 环境 + 当前工作区
agent-audit --checks ports,mcp  # 只跑指定检查
agent-audit --skills-dir ~/agents/skills --config-dir ~/agents

或安装为命令行工具：

pip install .            # 或 pipx install .
agent-audit --version

全部检查均为只读操作（netstat / 文件读取 / icacls 查询 / git ls-files），不会修改任何配置。

7 项检查

判定哲学：不要只数 skill 数量——外发端点白名单才是决定性证据（数量多 ≠ 有问题，端点全白名单 = 安全）。

报告

输出 Markdown + JSON 双格式到 agent-audit-reports/：

• 审计完成标准表：6 条来自实战的验证标准，逐条 ✅/❌
• 详细发现：严重度 / 证据 / 修复建议，每条发现都带可执行的修复命令
• 修复优先级清单：critical → medium 排序
• JSON 报告含全部结构化细节（监听列表、端点分类计数、MCP 逐 server 判定）

退出码：0 通过 / 1 存在 ≥ 阈值的发现（默认 high，可作 CI 门禁）/ 2 参数错误。

# CI 门禁用法
python -m agent_audit --severity-threshold high || exit 1

配置文件（可选）

# audit.toml
[paths]
skills_dirs = ["C:/Users/me/AppData/Local/hermes/skills"]
config_dirs = ["C:/Users/me/AppData/Local/hermes"]
workspaces  = ["D:/my-vault"]
mcp_configs = ["C:/Users/me/AppData/Local/hermes/config.yaml"]

[ports]
watch   = { 18789 = "OpenClaw 网关", 8188 = "ComfyUI" }
system_noise = [135, 445]

[endpoints]
whitelist = ["api.my-company.com"]

python -m agent_audit -c audit.toml

默认路径自动探测：Hermes（%LOCALAPPDATA%/hermes，非 Windows 为 ~/.hermes）、Claude Desktop（%APPDATA%/Claude）；--skills-dir / --config-dir / --mcp-config / --workspace 可多次指定，叠加在配置文件之后。

文档

• MCP Server 安全审计白皮书 — 5 项 OWASP 对齐判定清单，可直接落地
• 系列文章：我给自己的 AI Agent 环境做了次安全审计 — 真实机器的完整审计记录

设计原则

• 零运行时依赖：安全审计工具自己先做好供应链（PyYAML 可选，缺失时自动降级解析）。
• 全程只读：只查询、不修改；修复动作以命令形式写在报告里，由人决定是否执行。
• Windows 优先：icacls / netstat / tasklist 一等公民——大部分 agent 安全工具默认 Linux，Windows 用户的 agent 环境没人管。
• 证据导向：每条发现附带证据（文件:行号、URL、ACL）与修复命令，不吓唬人。

Roadmap

• skill-vetter 集成：skill 安装前审查
• --fix 模式：一键收紧权限 / 改监听（带确认）
• OWASP Agentic AI Top 10 完整映射
• GitHub Action：PR 时自动跑依赖 + git 泄漏检查

License

MIT