AgentGuard

核心用法

AgentGuard 是一款专为 AI 代理设计的本地安全监控基础设施，通过持续后台监控、规则引擎与轻量 ML 分析，构建完整的操作可见性体系。

五大核心模块：

| 模块 | 功能 | 典型场景 |

|------|------|----------|

| 文件监控 | 追踪读写操作、敏感目录访问、批量读取模式 | 检测凭证文件(.env)被异常读取 |

| API 监控 | 拦截未知端点、频率异常、Token 泄露 | 阻止或告警调用恶意域名 |

| 通信日志 | 记录 HTTP/WebSocket/邮件/IM 全链路 | 生成合规审计追踪 |

| 异常检测 | 基线偏离、时段异常、序列分析 | 识别「深夜大量文件读取→外发API」的泄露链 |

| 安全报告 | 自动生成日报/周报，含威胁时间线与修复建议 | 运营团队晨会安全简报 |

关键配置亮点：

• block_on_suspicious: true 时可主动阻断可疑 API 调用
• hash_sensitive_data: true 确保日志零明文凭证
• 支持 Telegram 等渠道实时告警，15 分钟冷却防刷屏

---

显著优点

1. 防御纵深设计：明确假设「代理可能被攻破」，监控进程建议独立运行，即使主代理被控仍可留存证据
2. 零外部依赖：全本地处理，拒绝遥测，满足金融/医疗等敏感场景
3. 低误报优化：支持基线学习期 + 三级敏感度调节，避免「狼来了」疲劳
4. 结构化数据：行为基线模型、告警 JSON、Markdown 报告分层存储，便于 SIEM 对接

---

潜在局限与风险

| 局限 | 说明 |

|------|------|

| 性能开销 | 持续文件系统监控与 payload 哈希计算，高 I/O 场景可能拖慢代理响应 |

| 基线污染攻击 | 攻击者在学习期内植入正常行为模式，可降低后续检测率 |

| 加密盲区 | 若代理使用端到端加密外发数据，payload 哈希无法识别内容风险 |

| 配置即安全边界 | `block_on_suspicious: false` 仅告警不阻断，需人工确认是否开启强制拦截 |

---

适合人群

• AI 平台运维团队：管理多租户代理，需统一审计平面
• 安全合规工程师：满足 SOC2/等保对 AI 系统的操作可追溯要求
• 高敏感场景开发者：处理医疗记录、金融数据的 RAG/Agent 应用
• 红队/安全研究员：分析代理行为边界，发现提示注入后的实际利用链

---

常规风险提醒

• 日志爆炸：默认 30 天保留，高活跃代理可能产生 GB 级日志，建议配置自动轮转
• Token 泄露于 URL：若代理将 API key 置于 query string，URL 日志可能意外暴露，需启用 hash_sensitive_data
• 告警通道单点故障：仅配置 Telegram 时，若 bot 被封或网络隔离将丢失关键告警，建议多通道冗余
• 权限逃逸：监控进程本身若拥有过高权限，被攻破后将成为「上帝视角」后门，务必遵循最小权限原则

概述

AgentGuard 是一款专为 AI 代理设计的综合性安全监控 Skill，由 Manas AI 开发并通过 CLS 安全认证（评分 82/A 级）。该工具采用"防御纵深"原则设计，假设代理可能被入侵或操纵，因此提供全方位的操作可见性。

核心功能

AgentGuard 提供五大核心能力：文件访问监控（追踪读写操作、敏感目录访问、数据外泄模式）、API 调用检测（识别未知端点、频率异常、Token 暴露）、通信日志记录（HTTP/WebSocket/消息平台的审计追踪）、异常行为检测（基于 ML-lite 的基线偏离分析）以及自动化安全报告（日/周/月报含威胁趋势与建议）。

显著优势

1. 零外部数据传输：所有处理本地完成，日志支持 AES 加密与敏感数据哈希脱敏
2. 智能基线学习：自动建立正常行为模式，减少误报
3. 深度集成：与 Clawdbot 生态无缝对接，支持实时告警阻断
4. 合规就绪：通过 GDPR/CCPA 认证，满足审计与合规需求
5. 灵活配置：敏感度三级可调，支持 15 分钟告警冷却防止风暴

潜在局限

• 权限依赖：文件监控需目标目录读取权，误配可能暴露敏感系统路径
• 基线建立期：需 24 小时学习期才能达到最佳检测效果
• Python 生态限制：watchdog 为可选依赖，部分平台实时监控性能受限
• 无主动阻断默认： suspicious API 调用默认仅告警不拦截，需显式启用 block_on_suspicious: true

适用场景

• 多代理协作环境中的操作审计与追责
• 处理敏感数据（凭证、PII）的代理安全加固
• 满足 SOC 2/ISO 27001 等合规要求的日志留存
• 开发阶段代理行为调试与异常模式发现

风险提示

1. 配置风险：监控目录过宽可能导致敏感信息意外采集，建议严格限定 file_watch_dirs
2. 日志累积：默认 30 天保留期需定期审查，高敏感环境建议缩短
3. 告警疲劳：high 敏感度模式在活跃环境中可能产生大量误报
4. 进程隔离建议：认证报告明确建议将 AgentGuard 置于独立进程运行，防止被入侵代理禁用监控

技术亮点

采用标准 Python 库为主架构，代码结构清晰（1,247 行/8 文件），静态分析得分 85，无危险系统调用。支持五种严重级别的可视化告警（🔵🟢🟡🟠🔴），并提供可导出的 Markdown 格式日报。