ClawButler 文档
以 OpenClaw 为核心、同时覆盖本地 runtime 的治理平台 — 提供监控、审批、控制与完整审计追踪。
什么是 ClawButler？#
组织现在往往同时运行 OpenClaw 网关和本地编码 runtime。成本增长缺乏可见性，高风险操作绕过审核，Hermes / Claude Code / Codex 的本机会话也长期处于割裂状态。
ClawButler 正是弥合这一鸿沟的治理层。它保持 OpenClaw-first，同时也支持配对 Runtime Host，用来发现 Hermes、Claude Code、Codex 与 OpenClaw 实例，把选中的 runtime 作为 connector 接入，并将 attach-mode 会话投影进同一个控制面。
基于开放标准构建 — MCP（Model Context Protocol，由 Anthropic 发布）连接 Agent 与工具和数据，A2A（Agent2Agent Protocol，由 Google 发布）实现 Agent 间协作 — ClawButler 完全开源。当前 OpenClaw connector 仍是能力最完整的正式路径；Runtime Host 集成扩展了可见性，但不应表述成完整的 provider-native 同权支持。
核心概念#
Agent 注册中心
统一身份层，既管理 OpenClaw connectors，也管理通过 Runtime Host 发现并接入的实例。它把启停控制、结构化配置标签和健康追踪集中到同一个控制面。
MCP 协议
由 Anthropic 发布的开放标准，用于连接 AI 应用与外部数据源和工具。ClawButler 基于 MCP 自动发现 Agent 及其能力 — 工具、文件、数据库 — 提供统一的认证和访问控制。
A2A 互操作
由 Google 发布的开放协议，用于 Agent 间通信与互操作。A2A 与 MCP 互补：MCP 连接 Agent 与工具，A2A 让 Agent 彼此委派任务和共享上下文 — 具备完整的授权和审计追踪。
HITL 审批
人在回路工作流在高风险操作执行前进行拦截。支持可配置规则，包含风险等级评估、成本预估和批量处理 — 可选择一次允许或始终允许受信任的模式。
审计追踪
带有单调递增序列 ID 的仅追加事件日志，记录每个 Agent 操作。追踪链路将跨 Agent 的关联操作串联，PII 脱敏在确保合规的同时保持问责性。
工作原理#
连接
接入 OpenClaw 网关，或先配对一台 Runtime Host。ClawButler 可以发现 OpenClaw 以及 Hermes / Claude Code / Codex 实例，并只注册你选择治理的对象。
监控
通过实时 SSE 流、成本分析和健康监控追踪每个 connector 与会话投影。attach-mode session sync 让本地 runtime 的调查也拥有统一时间线。
治理
设置审批、预算和监控。OpenClaw 仍是治理能力最完整的控制路径；Runtime Host 集成当前主要覆盖发现、connector 接入和 attach-mode session sync。
技术栈#
| 层级 | 技术 |
|---|---|
| Web | Next.js 15 (App Router) + React 19 + Tailwind CSS 4 + Auth.js v5 |
| API | FastAPI + Python 3.12 + SQLAlchemy 2 (async) + Alembic + structlog |
| Database | PostgreSQL 17 + Valkey 8 (Redis-compatible) |
| CI | GitHub Actions (lint / typecheck / test / build) |
| Deploy | Docker Compose + Caddy reverse proxy (auto HTTPS) |
快速开始#
准备好治理 OpenClaw 与本地 runtime 了吗？
免费开始，几分钟内配对 Runtime Host；或选择自托管获得完整的数据隐私与运维控制。