pantherstar/clawguard

# ClawGuard 面向 OpenClaw 代理的安全中间件。防御文本、图像、PDF 和音频中的提示注入攻击。通过 Base Sepolia 将威胁情报上链共享。 为黑客松构建 — 演示可用，非生产环境。 ## 架构 ``` Inbound Content → Extraction → Detection Pipeline → Verdict ↓ ↓ OCR / PDF / Whisper Rules → Classifier → LLM Judge HTML / Email parse ↓ On-chain threat cache (instant block) ↓ Base Sepolia registry (shared intel) ``` **检测流水线** 短路执行：如果正则规则足够自信（严重性 >= 0.9），则在调用分类器或 LLM 评判器之前直接拦截。ML 分类器（deepset/prompt-injections distilbert）处理规则遗漏的情况。LLM 评判器（Claude Haiku）仅在存在模糊情况时介入。 ## 快速启动 ``` cd clawguard # 1. 安装依赖 make setup # 2. 配置密钥 cp .env.example .env # 至少填写 ANTHROPIC_API_KEY # 3. 生成攻击固件 make fixtures # 4. 运行演示 make demo ``` ### 完整仪表板演示 ``` # 终端 1: API 服务器 make api # 终端 2: 仪表板 make dashboard # 终端 3: 运行演示代理 make demo # 打开 http://localhost:5175 ``` ## 环境变量 | 变量 | 是否必需 | 描述 | |---|---|---| | `ANTHROPIC_API_KEY` | 是 | 用于 LLM 评判器和视觉模型 | | `BASE_SEPOLIA_RPC_URL` | 否 | 默认：`https://sepolia.base.org` | | `CLAWGUARD_PRIVATE_KEY` | 否 | 用于发布到链上注册表 | | `CLAWGUARD_REGISTRY_ADDRESS` | 否 | 已部署的 `ThreatRegistry` 地址（旧环境变量名） | | `ALPACA_API_KEY` | 否 | Alpaca 纸面交易（仅演示） | | `ALPACA_SECRET_KEY` | 否 | Alpaca 纸面交易（仅演示） | 演示可在无链上或 Alpaca 组件的情况下运行，这些组件会优雅降级。 ## 合约部署（可选） ``` # 安装 Foundry curl -L https://foundry.paradigm.xyz | bash && foundryup # 部署到 Base Sepolia make contracts # 将部署地址复制到 .env 作为 CLAWGUARD_REGISTRY_ADDRESS ``` ## 分阶段攻击 `demo/attacks/` 中包含三个攻击样本： 1. **`bloomberg_email.eml`** — 伪造的 Bloomberg 收益预警，在 HTML 注释和 `display:none` 的 `