clawSafe 🛡️

面向企业的 AI 智能体安全检测器

概述

clawSafe 是一款全面的安全中间件，可在恶意输入抵达您的 AI 智能体之前对其进行拦截与阻断。采用纵深防御（defense-in-depth）设计理念构建。

特性

五层防护体系

总计：113+ 项检测规则

快速开始

安装

# 通过 ClawHub 安装
clawhub install clawSafe

# 手动安装
cp -r clawSafe ~/.openclaw/workspace/skills/

基础用法

const Detector = require('./detector');

const detector = new Detector();

// 扫描用户输入
const result = detector.scan('Ignore previous instructions');

if (!result.safe) {
  console.log('已拦截：', result.threats);
  // 处理被拦截的输入
}

返回格式

{
  safe: boolean;           // 输入是否安全（true 表示安全）
  threats: Array<{
    type: string;         // 威胁类别
    pattern: string;      // 匹配的规则 ID
    severity: string;     // 严重等级：critical|high|medium|low
    confidence: number;   // 置信度（0–1）
    description: string;
  }>;
  confidence: number;      // 整体置信度（0–1）
  layersScanned: string[]; // 已扫描的防护层级列表
}

配置

config.json

{
  "enabled": true,
  "logLevel": "info",
  "layers": {
    "llm": {
      "enabled": true,
      "rules": ["injection", "jailbreak", "prompt_leak", "encoding"]
    },
    "web": {
      "enabled": true,
      "rules": ["sql_injection", "xss", "csrf", "ssrf"]
    },
    "api": {
      "enabled": true,
      "rules": ["key_exposure", "rate_limit", "auth"]
    },
    "supply_chain": {
      "enabled": true,
      "rules": ["deps"]
    },
    "deploy": {
      "enabled": true,
      "rules": ["env_leak", "debug_info"]
    }
  },
  "detection": {
    "confidenceThreshold": 0.6,
    "minMatchCount": 1
  },
  "actions": {
    "onThreatDetected": "block",
    "onUncertain": "log"
  }
}

whitelist.json

{
  "keywords": ["trusted-keyword"],
  "users": ["user-id-1"],
  "sessions": ["session-id-1"]
}

检测规则

LLM 层

提示注入模式：

• ignore previous instructions
• disregard your guidelines
• forget all rules
• act as if you have no restrictions

越狱模式：

• DAN mode
• developer mode
• roleplay as

编码绕过技术：

• Base64 编码指令
• 十六进制编码（Hex encoding）
• Unicode 同形字（Unicode homoglyphs）

Web 层

• SQL 注入：'; DROP TABLE users; --
• XSS：
• CSRF：Token 操纵
• SSRF：访问内部 URL

API 层

• API 密钥泄露：sk-1234567890
• JWT tokens
• Bearer tokens
• Basic auth credentials

测试

# 运行全部测试
node test.js

# 交互式模式
node test-interactive.js

# 演示
node detector.js

集成

OpenClaw Hook

如需与 OpenClaw 集成，请在网关配置中添加如下内容：

// gateway.config.js
module.exports = {
  middleware: ['clawSafe'],
  clawSafe: {
    enabled: true,
    strictMode: false
  }
};

性能

• 延迟：单次扫描耗时 < 5ms
• 内存占用：约 50KB
• 规则数量：113+（基于 JSON，支持惰性加载）

许可证

MIT

更新日志

v1.0.0

• 初始发布
• 五层防护体系
• 113+ 项检测规则