Claw Patrol

随着 AI 智能体（Agent）逐渐深入业务核心，其自主执行代码、查询数据库及管理基础设施的能力也带来了前所未有的安全风险。Claw Patrol 是一款专为智能体设计的安全防火墙，它位于 Agent 与生产环境之间，通过在数据包层面解析流量并匹配用户自定义的 HCL 规则，实现对每一个潜在危险操作的精准管控。无论是阻止恶意 SQL 查询，还是暂停高风险的 Kubernetes 删除命令，Claw Patrol 都能确保 AI 在安全边界内运行。

核心亮点：细粒度管控、协议感知、灵活部署

1. 数据包层面的深度检测

• 协议解析：不仅监控 HTTP，还能深入解析 SQL 动词与表名、Kubernetes 资源/动词/命名空间等结构化信息。
• CEL 条件表达式：使用强大的 Common Expression Language (CEL) 编写规则，基于网关提取的原始事实进行逻辑判断，实现极高的灵活性。

2. 声明式 HCL 规则引擎

• 直观配置：通过简洁的 HCL 文件定义安全策略，例如禁止 Agent 读取 K8s Secrets 或限制特定 HTTP 路径。
• 人工审批集成：支持将高风险操作（如 kubectl delete）设置为“暂停”，直到获得人工批准后方可执行，形成人机协同的安全闭环。

3. 三种灵活部署形态

• Gateway 模式：作为独立代理运行，加载 HCL 配置，接受通过 WireGuard 或 Tailscale 接入的客户端。
• Join 模式：启动 WireGuard 隧道，路由整个主机的所有流量通过网关进行审计。
• Run 模式：在 Linux/macOS 上按进程隔离打开隧道，仅包装特定命令（如 clawpatrol run claude）的流量，实现最小化侵入。

规则示例：真实生产配置

以下规则展示了如何禁止智能体通过 Kubernetes API 读取 Secret 数据：

rule "k8s-no-secrets" {
  endpoint  = k8s-prod
  condition = "k8s.resource == 'secrets'"
  verdict   = "deny"
  reason    = "Secret values must not leave the cluster via the agent"
}

支持的事实字段包括：

• SQL: 动词 (SELECT/DELETE)、表名、库名。
• Kubernetes: 资源类型 (Pod/Secret)、动词 (Get/Delete)、命名空间。
• HTTP: 方法 (GET/POST)、路径、请求头、请求体。

快速开始

1. 安装

# 一键安装
curl -fsSL https://clawpatrol.dev/install.sh | sh

# 或从源码编译
make

2. 运行

作为网关运行：

clawpatrol gateway config.hcl

包装特定智能体进程（推荐用于开发测试）：

clawpatrol run claude

此命令会在当前终端启动 Claude，并将其所有网络流量通过 Claw Patrol 网关进行过滤。

加入现有网关（用于主机级防护）：

clawpatrol join <gateway-url>

适用场景

• 企业级 AI 应用：防止内部 AI 助手意外泄露敏感数据或执行破坏性数据库操作。
• 云原生运维自动化：在使用 AI 辅助 K8s 管理时，强制实施最小权限原则，避免误删生产资源。
• 开发者本地环境：在本地调试 AI Agent 时，实时监控其行为，确保测试代码不会污染外部服务。
• 合规与审计：记录所有 AI 发起的网络请求与操作日志，满足金融行业或医疗行业的安全合规要求。