**全球最强大的 AI Agent 审计与治理工具包**
[](LICENSE)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)
[](https://pnpm.io/)
[](https://clawhub.ai/MackDing)
[](https://github.com/Claws-ZH/claws-shield/actions/workflows/ci.yml)
[English](./README_EN.md) | **中文**
> 源自对 Claude Code v2.1.88（512K 行 TypeScript）的深度逆向工程分析。
> 现已支持审计**任意** AI 编码工具。
---
## 目录
- [什么是 Claws-Shield？](#什么是-claws-shield)
- [核心工具](#核心工具)
- [快速开始](#快速开始)
- [审计报告](#审计报告)
- [安全扫描规则](#安全扫描规则)
- [知识库](#知识库)
- [项目架构](#项目架构)
- [CI/CD 集成](#cicd-集成)
- [开发指南](#开发指南)
- [隐私声明](#隐私声明)
- [贡献](#贡献)
- [许可证](#许可证)
---
## 什么是 Claws-Shield？
AI 编码助手正在成为开发者的标配工具，但你真的了解它们在背后做了什么吗？
Claws-Shield 是一个包含 **4 个核心工具** 的 monorepo，旨在为 AI 编码代理带来**透明度**和**安全性**。无论你是想审计 AI 工具的隐私行为，还是在安装 OpenClaw 技能前进行安全扫描，Claws-Shield 都能帮到你。
## 核心工具
| 工具 | 描述 | ClawHub |
|:-----|:-----|:--------|
| **Agent Auditor** | 审计任意 AI 工具的遥测、远程控制、权限、隐私和隐藏功能，生成 A-F 等级报告 | [`agent-auditor`](https://clawhub.ai/MackDing/agent-auditor) |
| **Agent Intelligence** | 基于研究的情报数据库，包含 250+ 功能开关、模型代号、隐藏功能和版本差异 | [`agent-intelligence`](https://clawhub.ai/MackDing/agent-intelligence) |
| **Skill Security Scanner** | 扫描 OpenClaw 技能中的恶意软件、提示注入、混淆、供应链攻击和数据外泄 | [`claws-security-scanner`](https://clawhub.ai/MackDing/claws-security-scanner) |
| **Agent Gateway** | 多模型智能路由（Claude、GPT、Gemini、Ollama），支持成本优化和故障自动转移 | [`agent-gateway`](https://clawhub.ai/MackDing/agent-gateway) |
## 快速开始
### 方式一：CLI 独立使用
```bash
# 审计 AI 工具源码
npx @claws-shield/cli audit ./path-to-ai-tool-source
# 扫描技能安全性
npx @claws-shield/cli scan ./path-to-skill
# 查询情报数据库
npx @claws-shield/cli intel "capybara codename"
# 启动多模型网关
npx @claws-shield/cli gateway --port 8787
```
### 方式二：OpenClaw 技能一键安装
```bash
clawhub install agent-auditor
clawhub install agent-intelligence
clawhub install claws-security-scanner
clawhub install agent-gateway
```
### 方式三：编程调用
```typescript
import { runAudit, formatMarkdown } from "@claws-shield/auditor"
import { scanSkill } from "@claws-shield/scanner"
import { loadIntelDatabase, searchAll } from "@claws-shield/intel"
import { Router, ProviderRegistry } from "@claws-shield/gateway"
// 审计 AI 工具
const report = await runAudit("./claude-code-source")
console.log(formatMarkdown(report))
// 扫描技能安全问题
const scan = await scanSkill("./my-skill")
console.log(scan.securityGrade) // "A"
// 查询情报数据库
const db = loadIntelDatabase()
const results = searchAll(db, "telemetry")
// 智能路由 LLM 请求
const registry = new ProviderRegistry()
const router = new Router(registry)
const response = await router.route({
messages: [{ role: "user", content: "你好" }]
}, "cheapest")
```
## 审计报告
