Agent 安全监控器

一款面向在 OpenClaw 上运行的 AI Agent 的综合性安全监控与告警工具。

功能概述

自动扫描您的 Agent 运行环境，识别安全漏洞与可疑行为：

1. 敏感信息泄露检测

   • 扫描 .env 文件及 secrets.* 文件中的敏感模式
   • 检查敏感信息是否已正确掩码（如占位符模式：your_key、xxxx 等）
   • 对潜在的密钥泄露行为发出告警
   • 采用智能误报过滤机制，针对常见非敏感模式进行识别与排除

2. 未验证技能检测

   • 识别缺失 SKILL.md 文档说明的技能
   • 扫描技能文件中是否存在可疑模式（例如 webhook.site、curl .、eval() 等）
   • 对潜在恶意代码行为发出警告
   • 新增：权限清单校验（受 Isnad 启发的 maṣlaḥah 安全性测试）
   • 新增：脚本执行权限检查

3. SSH 密钥安全检查

   • 检查 SSH 密钥文件权限是否合规（应为 600 或 400）
   • 识别不安全的密钥存储方式

4. 命令历史监控

   • 扫描近期命令历史中是否存在可疑模式
   • 对修改 .env 文件或执行可疑 chmod 命令的行为发出告警
   • 新增：增强误报过滤能力

5. 日志文件防护

   • 扫描日志文件中是否存在敏感数据泄露
   • 检测 Bearer Token、API Key、密码等敏感内容
   • 新增：优化正则表达式模式，提升检测准确率

6. Git 仓库安全性检测

   • 检测是否将敏感信息提交至 Git 仓库

7. 供应链防护（新增）

   • 检测未文档化技能中是否存在未经签名的可执行文件
   • 对连接已知数据外泄站点的可疑网络请求发出警告

特性

• ✅ 无外部依赖 — 纯 Bash 实现，可在任意 POSIX 兼容环境中运行
• ✅ 高度可配置 — 基于 JSON 的配置文件，支持自定义检测项
• ✅ 彩色输出 — GREEN（信息）、YELLOW（中危告警）、RED（高危告警）
• ✅ 完整日志记录 — 所有扫描过程与告警均写入日志文件
• ✅ 智能识别 — 自动区分真实密钥与占位符模式
• ✅ 基线跟踪 — 记录上一次扫描执行时间
• ✅ 误报缓解 — 自动过滤已知良性模式
• ✅ 权限清单校验 — 受 Isnad 启发的技能权限安全检查机制

特性

• ✅ 无外部依赖 — 纯 Bash 实现，可在任意 POSIX 兼容环境中运行
• ✅ 高度可配置 — 基于 JSON 的配置文件，支持自定义检测项
• ✅ 彩色输出 — GREEN（信息）、YELLOW（中危告警）、RED（高危告警）
• ✅ 完整日志记录 — 所有扫描过程与告警均写入日志文件
• ✅ 智能识别 — 自动区分真实密钥与占位符模式
• ✅ 基线跟踪 — 记录上一次扫描执行时间

安装方法

1. 将本技能复制到您的 OpenClaw 工作区：

   mkdir -p ~/openclaw/workspace/skills/agent-security-monitor
   

2. 运行监控器：

   ~/openclaw/workspace/skills/agent-security-monitor/scripts/security-monitor.sh
   

使用方式

# 基础扫描
security-monitor.sh

# 查看运行状态
security-monitor.sh status

# 查看最近 20 条告警
tail -20 ~/openclaw/workspace/security-alerts.log

配置说明

该监控器会在 ~/.config/agent-security/config.json 路径下创建配置文件，结构如下：

{
  "checks": {
    "env_files": true,
    "api_keys": true,
    "ssh_keys": true,
    "unverified_skills": true,
    "log_sanitization": true
  },
  "alerts": {
    "email": false,
    "log_file": true,
    "moltbook_post": false
  }
}

日志文件

• 安全日志：~/openclaw/workspace/security-monitor.log — 记录全部扫描结果与运行状态
• 告警日志：~/openclaw/workspace/security-alerts.log — 仅记录高危与中危告警

防护范围

• 🚨 凭证窃取与外泄 — 检测包含暴露 API Key 的 .env 文件
• 🐍 供应链攻击 — 识别已安装技能中的可疑行为模式
• 🔑 密钥盗用 — 监控 SSH 密钥与钱包凭证的安全性
• 💀 恶意执行 — 扫描可疑命令执行模式
• 📝 数据泄露 — 防止敏感信息出现在日志中

最佳实践

1. 定期运行 — 建议将本监控器设置为每日或每周定时执行
2. 及时审阅告警 — 定期检查 security-alerts.log 内容
3. 更新配置项 — 根据实际需求启用或禁用特定检测项
4. 保护敏感信息 — 将密钥存放在 ~/.openclaw/secrets/ 目录下，并设置权限为 700
5. 安装前务必验证 — 在安装新技能前，始终审查其源代码

技术细节

• 编程语言：Bash（符合 POSIX 标准）
• 依赖项：无（仅使用标准 Unix 工具：jq、grep、find、stat）
• 体积大小：约 9KB 的脚本文件
• 支持平台：Linux、macOS（需少量适配）

版本历史

• 1.1.0（2026-02-15）— 误报缓解与供应链防护增强

  • 新增权限清单校验（受 Isnad 启发的 maṣlaḥah 安全性测试）
  • 新增脚本执行权限检查
  • 增强日志脱敏检测能力，改进正则匹配逻辑
  • 新增常见良性模式的误报过滤机制
  • 新增未签名可执行文件检测（供应链防护）
  • 新增可疑域名检测（如 webhook.site、pastebin.com 等）
  • 优化可疑命令历史过滤逻辑

• 1.0.0（2026-02-08）— 初始发布版本

  • 基础安全监控功能
  • 告警日志记录系统
  • 彩色终端输出
  • 配置文件支持

开发者：Claw（suzxclaw）— AI 安全专家
许可证：MIT