快速上手
从首次 Runtime Host 配对或 connector 接入，到日常运维的完整指南。
欢迎#
ClawButler 是一个以 OpenClaw 为核心、同时覆盖本地 runtime 的治理层。它既可以连接 OpenClaw 网关，也可以配对 Runtime Host 来发现 Hermes、Claude Code、Codex 与 OpenClaw 实例，再把选中的 runtime 纳入统一控制面，执行监控、审批、成本追踪和审计。
本手册与 ClawButler Web 控制台的侧边栏导航一一对应。每个页面介绍一个功能模块——如何配置、会看到什么、以及如何在 Web、CLI 和移动端操作。
架构概览#
ClawButler 要么通过安全 WebSocket connector 连接 OpenClaw 网关，要么通过 Runtime Host / Edge Agent 建立配对。接入后，它会同步 Agent、发现到的 runtime 实例、事件、成本、健康状态，以及在支持场景下的 attach-mode 会话。
开始之前#
云服务用户
在 clawbutler.cc 注册账号并验证邮箱。浏览器侧无需安装控制面；只需要在目标机器上配对 Runtime Host 或 Edge Agent。
自托管用户
参照自托管指南部署 ClawButler。需要 Docker、Node.js 22+ 和 Python 3.12+。
Runtime Host 或 OpenClaw Gateway
Cloud 推荐从 Runtime Host / Edge Agent 配对开始。自托管或高级环境也可以手动接入 OpenClaw gateway。请准备好配对码、gateway URL 和 operator token。
5 分钟快速入门#
功能模块索引#
侧边栏中每个模块都有对应的详细指南，点击任意模块了解配置和使用方法。
运营 — Agent 生命周期与实时运维
一览 Agent 状态、成本、审批和实时活动。
从统一注册表发现、配置和管理 Agent。
通过 HITL 工作流审批高风险 Agent 操作。
实时查看所有 Agent 操作的事件流。
检查 Agent 会话——消息、工具调用和成本。
Agent 间关系和调用链的可视化拓扑图。
直接与 Agent 对话的交互界面。
洞察 — 分析、成本追踪与合规审计
搜索、筛选和导出不可变的审计日志。
按 Agent 归因的成本分析、趋势图表和异常告警。
设置成本限额、跟踪支出并接收超限告警。
监控定时任务——状态、下次执行和历史记录。
快照版本管理、语义差异对比和回滚预览。
全局使用分析和运维指标。
效率 — 自动化、模板与报告
Agent 持久记忆条目的搜索和管理。
监控工具可用性、使用情况和权限边界。
按需生成和导出运维报告。
浏览和部署经过验证的 Agent 配置模板。
支持多种调度器的多步骤自动化。