denoland/clawpatrol

来源：https://github.com/denoland/clawpatrol

clawpatrol

面向智能体的安全防火墙。Claw Patrol 位于智能体与生产环境之间，在线缆层面解析其流量，并根据你用 HCL 编写的规则对每个操作进行门控。例如，你可以阻止破坏性 SQL，或者在请求到达 Kubernetes 之前暂停 kubectl delete pod，直到人工批准为止。完整概览请参见 clawpatrol.dev (https://clawpatrol.dev)。

安装

curl -fsSL https://clawpatrol.dev/install.sh | sh

从源码编译：make（需要 Go 和 Node.js）。

一个规则示例

这是我们自己生产配置中的一个真实规则：

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

条件（condition）是基于线缆层面事实的 CEL 表达式，网关针对不同协议提取这些事实：Postgres / ClickHouse 对应 SQL 动词和表名，Kubernetes 对应资源 / 动词 / 命名空间，HTTP 对应方法 / 路径 / 请求头 / 请求体。完整的事实列表请参见配置参考文档 (https://clawpatrol.dev/docs/config-reference)。

运行

三种部署形态，选择适合你的：

clawpatrol gateway config.hcl   # 运行代理本身
clawpatrol join                 # 加入一个网关
clawpatrol run claude           # 包裹单个智能体的进程树

clawpatrol run 会在 Linux（通过 netns）或 macOS（通过 NetworkExtension）上打开一个按进程隔离的隧道；只有被包裹命令的流量会经过网关。
clawpatrol join 会拉起一个 WireGuard 隧道，路由整个主机的流量。
clawpatrol gateway 是代理：一个单一二进制文件，加载你的 HCL 配置，并接受客户端通过 WireGuard 或 Tailscale 隧道接入。

配置

clawpatrol.dev/docs/getting-started (https://clawpatrol.dev/docs/getting-started) 带你从头到尾完成第一个配置。
clawpatrol.dev/docs/config-reference (https://clawpatrol.dev/docs/config-reference) 是自动生成的字段参考文档。
参见 gateway.example.hcl 获取带有注释的起始模板。

许可证

MIT。详见 LICENSE.md。