English | 中文

🎯 如果你符合以下情况，ClawVault 就是为你而生：

• ✅ 你在与 AI 代理交互时担心个人隐私数据泄露
• ✅ 你希望阻止 AI 代理访问 API 密钥、私有文件和凭据
• ✅ 你需要防止 AI 代理误操作敏感或机密文件
• ✅ 你想记录 AI 如何与你的私有数据互动
• ✅ 你需要检测 AI 注入攻击和危险命令

立即激活你的个人 AI 保险库：

• 1️⃣ 加载私有文件
• 2️⃣ 设置并自定义你的安全存储
• 3️⃣ 创建远程管理技能

https://github.com/user-attachments/assets/2098b271-f844-4db5-b44a-f836e36d314c

效果

https://github.com/user-attachments/assets/d580cfa1-8410-4095-90cb-3d693413a24e

核心能力

1. 可视化监控

用户可以配置自己的“保险库”，将关注的代理、技能、凭据和文件锁定其中。当有人触碰这些资产时，“安全龙虾”会通过即时通讯工具通知你：昨天谁在你的保险库中动了什么。

技术实现：

• 基于 API 网关和文件侧监控的事件收集（调用记录、文件访问、变更追踪）
• 支持定期变更通知和实时告警

2. 原子级控制

以可组合的“原子能力”作为最小单位，在代理级别进行细粒度控制：

• 代理交互与调用策略
• 模型路由、白名单及配额控制
• 安全检测（敏感信息识别、凭据检测、提示注入防护等）
• 文件访问权限约束

用户可以像“搭积木”一样组合这些原子能力，创建可复用的策略配置。

3. 生成式能力

保险库中的每个“存储舱”都内置了基础的安全场景，并允许用户通过自然语言调用原子能力，添加检测场景和技能。

示例： 通过聊天界面告诉系统：

对于客服代理，如果用户上传包含“合同”的 PDF，
必须先经过敏感信息脱敏处理，
且仅允许使用 GPT-4o-mini，单次调用限制为 2000 个 token。

系统将自动生成功能相应的策略规则并执行。

---

✨ 功能

• 🔍 敏感数据检测 — API 密钥、密码、PII、信用卡等 15 种以上模式类型
• 🛡️ 提示注入防御 — 阻止角色劫持、指令覆盖、数据外泄
• ⚠️ 危险命令防护 — 拦截 rm -rf、curl|bash、权限提升等
• 🔄 自动脱敏 — 将秘密信息替换为占位符，响应时恢复
• 💰 Token 预算控制 — 日/月限额及费用预警
• 📊 实时仪表盘 — Web UI 提供代理配置、检测详情和快速测试功能

保险库包含一个透明代理网关模块，用于拦截你的 AI 工具与外部 API（如 OpenAI、Anthropic 等）之间的流量。

🚀 快速开始

https://github.com/user-attachments/assets/1f424172-8833-4ccc-b0d2-abf67c1758dd

方案 1：作为 OpenClaw 技能安装（推荐）

# 从 ClawHub 安装
openclaw skills install tophant-clawvault

# 或通过 clawhub CLI 安装
clawhub install tophant-clawvault

ClawHub: https://clawhub.ai/Martin2877/tophant-clawvault

该技能提供 AI 引导式的安装和管理：

• /clawvault install --mode quick - 快速设置
• /clawvault health - 检查状态
• /clawvault generate-rule "Block AWS credentials" - 创建安全规则
• /clawvault test --category all - 运行检测测试

更多技能文档请参见 [skills/tophant-clawvault/]。

方案 2：作为 Python 包安装

# 安装
pip install -e .

# 启动（代理 + 仪表盘）
clawvault start

# 扫描文本
clawvault scan "password=MySecret key=sk-proj-abc123"

# 交互式演示
clawvault demo

🚀 部署到服务器

# 一条命令：打包、上传、安装
./scripts/deploy.sh <server-ip> root

# 在服务器上：设置集成 + 启动
./scripts/setup.sh
./scripts/start.sh

📜 脚本

脚本	用途
scripts/deploy.sh <ip> [user]	部署到云服务器
scripts/start.sh	启动 ClawVault（添加 --with-openclaw 可同时启动 OpenClaw）
scripts/stop.sh	停止所有服务
scripts/test.sh	运行 CLI + API 测试
scripts/setup.sh	设置 OpenClaw 代理集成
scripts/uninstall.sh	卸载并恢复原状

🏗️ 架构

    OpenClaw
       │
       ▼
┌─────────────────────────────────┐
│    ClawVault (Security Vault)   │
├─────────────────────────────────┤
│ Gateway Module                  │
│  • Transparent Proxy  :8765     │
│  • Traffic Interception         │
├─────────────────────────────────┤
│ Detection Engine                │
│  • Sensitive data               │
│  • Injection patterns           │
│  • Dangerous commands           │
├─────────────────────────────────┤
│ Guard / Sanitizer               │
│  • Allow / Block / Sanitize     │
├─────────────────────────────────┤
│ Audit + Monitor                 │
│  • SQLite storage               │
│  • Token budget tracking        │
├─────────────────────────────────┤
│ Dashboard                       │
│  • Web UI :8766                 │
│  • Agent config & tests         │
└─────────────────────────────────┘

⚙️ 配置

# ~/.ClawVault/config.yaml
proxy:
  port: 8765
  intercept_hosts: ["api.openai.com", "api.anthropic.com"]

guard:
  mode: "interactive"  # interactive | strict | permissive

monitor:
  daily_token_budget: 50000

📊 开发进度

能力模块	状态	备注
API 网关监控与拦截	✅ 已实现	V1 核心能力
文件侧监控	🚧 进行中	逐步集成
代理级原子控制	🚧 进行中	网关端可用，正扩展至其他场景
生成式策略编排	🚧 进行中	逐步集成

---

📚 文档

文档	描述
开发环境搭建	本地开发环境
生产部署	部署到服务器
OpenClaw 集成	与 OpenClaw 对接
系统架构	系统设计与模块
防护模式	严格 / 交互式 / 宽松
应用场景	使用场景与路线图

完整文档索引请参见 doc/。

🛠️ 开发

git clone https://github.com/tophant-ai/ClawVault.git
cd ClawVault
python3 -m venv venv && source venv/bin/activate
pip install -e ".[dev]"
pytest

📄 许可证

MIT © 2026 Tophant

---

🤝 社区

• GitHub 问题 — Bug 报告与功能请求
• 安全问题 — 安全漏洞报告

---

ClawVault 快速上手指南

ClawVault 是一款开源的 AI 安全保险箱，旨在防止 AI 代理泄露隐私数据、访问敏感文件或执行危险命令。它通过透明代理网关拦截流量，提供细粒度的原子化控制、实时监测和自动脱敏功能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL2 推荐)
• Python 版本：3.10 或更高版本
• 前置依赖：
  • pip (Python 包管理工具)
  • git (用于克隆代码库)
  • (可选) OpenClaw 环境 (若选择技能模式安装)

安装步骤

您可以根据需求选择以下两种安装方式之一：

方式一：作为 OpenClaw 技能安装（推荐）

如果您已经在使用 OpenClaw 框架，这是最便捷的集成方式，支持 AI 引导式管理。

# 从 ClawHub 安装
openclaw skills install tophant-clawvault

# 或者使用 clawhub CLI 安装
clawhub install tophant-clawvault

方式二：作为 Python 包独立安装

适用于独立部署或开发测试场景。

# 克隆仓库
git clone https://github.com/tophant-ai/ClawVault.git
cd ClawVault

# 创建虚拟环境并激活
python3 -m venv venv
source venv/bin/activate  # Windows 用户请使用: venv\Scripts\activate

# 以开发模式安装
pip install -e .

基本使用

安装完成后，您可以通过以下方式快速启动和使用核心功能。

1. 启动服务（代理 + 仪表盘）

启动 ClawVault 后，它将运行一个透明代理网关（默认端口 8765）和一个 Web 管理仪表盘（默认端口 8766）。

clawvault start

提示：启动后，请将您的 AI 应用或工具的 API 请求地址指向 http://localhost:8765，即可自动获得安全防护。

2. 快速扫描测试

无需启动完整服务，可直接使用命令行检测文本中是否包含敏感信息（如 API Key、密码等）。

clawvault scan "password=MySecret key=sk-proj-abc123"

3. 交互式演示

运行内置的演示程序，体验完整的拦截、告警和脱敏流程。

clawvault demo

4. (仅限技能模式) 常用管理命令

如果您通过方式一安装，可以使用以下命令进行快速配置：

# 快速初始化设置
/clawvault install --mode quick

# 检查运行状态
/clawvault health

# 通过自然语言生成安全规则（例如：阻止 AWS 凭证）
/clawvault generate-rule "Block AWS credentials"

# 运行全类别检测测试
/clawvault test --category all

5. 服务器部署（可选）

若需部署到远程服务器，可使用内置脚本一键完成打包、上传和安装：

# 将 <server-ip> 替换为您的服务器 IP
./scripts/deploy.sh <server-ip> root

# 登录服务器后进行初始化和启动
./scripts/setup.sh
./scripts/start.sh