Openclaw Sec

🛡️ AI Agent 实时安全防护套件

security榜 #25

AI Agent实时安全防护套件,6大并行检测模块覆盖提示注入、命令注入、SSRF等威胁,20-50ms极速响应。

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

使用说明

核心用法

OpenClaw Security Suite 是一款专为 AI Agent 设计的实时安全防护工具,通过 6 个并行检测模块(提示注入、命令注入、SSRF、路径遍历、密钥泄露、内容扫描)对输入和工具调用进行毫秒级安全验证。用户可通过 /openclaw-sec 命令或 CLI 执行各类验证操作,包括 validate-commandcheck-urlvalidate-pathscan-content 和综合扫描 check-all。系统采用智能严重度评分机制,自动触发允许、警告、阻断或通知等分级响应。

显著优点

  • 全面威胁覆盖:6 大检测模块并行运行,涵盖 OWASP Top 10 中针对 AI 的主要攻击向量
  • 极速性能:目标 20-50ms 验证延迟,异步数据库写入不阻塞主流程,支持 1000+ 次/分钟吞吐量
  • 灵活配置:4 级敏感度(paranoid/strict/medium/permissive)+ 模块级独立配置,支持白名单用户绕过
  • 自动化集成:提供 user-prompt-submit-hook 和 tool-call-hook 自动钩子,实现透明防护
  • 完整可观测性:内置事件追踪、用户信誉评分、攻击模式分析和统计报表功能

潜在缺点与局限性

  • 误报风险:严格模式下提示注入检测可能将合法的多轮对话指令误判为攻击
  • 性能开销:secret_detector 模块使用大量正则表达式,在高并发场景下可能成为瓶颈
  • 依赖本地数据库:SQLite 存储在单节点部署时存在扩展性限制
  • 社区生态较新:相比成熟商业安全产品,第三方集成和威胁情报更新机制尚不完善
  • 云原生支持有限:目前主要针对本地 CLI/Hook 部署,容器化和服务网格集成文档较少

适合人群

  • AI Agent 开发者与运维团队,需要为 Claude Code、AutoGPT 等工具添加安全层
  • 企业安全团队,希望建立 LLM 应用的输入验证和审计追踪能力
  • 对数据隐私敏感的用户,倾向于本地部署而非云端安全 API

常规风险

  • 配置误用:将敏感度设为 permissive 并禁用关键模块可能导致防护形同虚设
  • 密钥管理:配置文件中明文存储 webhook URL 和数据库路径存在泄露风险
  • 数据库膨胀:默认 365 天数据保留期在高压测环境下可能导致磁盘空间耗尽
  • 绕过可能性:Determined attacker 可能利用 Unicode 规范化差异或上下文混淆构造对抗样本

安全解读

核心功能

OpenClaw Security Suite 是一款面向 AI Agent 系统的综合性安全验证工具,通过 6 个并行检测模块 实现实时威胁防护:

| 模块 | 检测威胁 |
|:---|:---|
| Prompt Injection Detector | 指令覆盖、角色操纵、越狱攻击 |
| Command Validator | 命令注入、危险命令链 |
| URL Validator | SSRF、内网探测、云元数据端点 |
| Path Validator | 目录遍历、敏感文件访问 |
| Secret Detector | API密钥、数据库凭证、私钥泄露 |
| Content Scanner | 编码混淆、策略违规内容 |

显著优势

  • 性能优异:并行架构实现 20-50ms 验证延迟,异步数据库写入不阻塞主流程
  • 配置灵活:4 级敏感度(paranoid/strict/medium/permissive),可按模块独立配置
  • 自动化防护:支持 Claude Code Hooks 自动拦截,无需修改业务代码
  • 可观测性强:内置事件追踪、用户信誉评分、攻击模式分析

潜在局限

1. 误报风险:严格模式下正则匹配可能拦截合法输入(如包含 rm 的技术文档)
2. 依赖本地存储:SQLite 数据库无内置加密,敏感安全事件以明文存储

3. T3 来源可信度:个人开发者维护项目,长期支持存在不确定性

4. 网络外发需警惕:Webhook/Slack/Discord 通知功能若配置不当,可能导致安全数据外泄

适用人群

| 场景 | 推荐配置 |
|:---|:---|
| 企业级 AI Agent 生产环境 | strict + block_notify |
| 内部工具/开发测试 | medium + warn |
| 高安全需求场景(金融、政务) | paranoid + 全模块启用 |

常规风险

  • 数据隐私:默认收集 user_id、session_id、输入指纹用于信誉评分,需明确告知用户
  • 供应链安全:依赖 better-sqlite3 等原生模块,需定期审计
  • Hook 权限:安装后具备拦截所有用户输入的能力,需确保来源可信

Openclaw Sec 内容

__tests__文件夹
integration文件夹
hooks文件夹
legacy文件夹
security-input-validator文件夹
security-tool-validator文件夹
src文件夹
__tests__文件夹
benchmarks文件夹
core文件夹
__tests__文件夹
hooks文件夹
modules文件夹
command-validator文件夹
__tests__文件夹
content-scanner文件夹
__tests__文件夹
path-validator文件夹
__tests__文件夹
prompt-injection文件夹
__tests__文件夹
secret-detector文件夹
__tests__文件夹
url-validator文件夹
__tests__文件夹
patterns文件夹
obfuscation文件夹
prompt-injection文件夹
runtime-validation文件夹
secrets文件夹
types文件夹
手动下载zip · 185.6 kB
end-to-end.test.tstext/plain
请选择文件