ClawMetry for OpenClaw

Clawmetry：OpenClaw 智能体的实时监控看板

在开发基于 OpenClaw 的智能体（Agents）时，开发者常常面临“黑盒”困境：智能体正在生成子智能体、消耗 Token、调用工具，但具体的执行细节却无从知晓。Clawmetry 正是为了解决这一痛点而生的专业监控工具。作为 OpenClaw 的官方增强套件，Clawmetry 提供了一个实时、开源且永久免费的仪表盘，让您对智能体的一举一动了如指掌。

什么是 Clawmetry？

Clawmetry 是一款专为 OpenClaw 量身定制的实时可视化监控系统。它能够深入 OpenClaw 的运行核心，将复杂的子智能体派生过程、Token 消耗、工具调用记录以及系统运行健康状况，转化为直观、易读的实时数据看板。

无论是个人开发者在笔记本上调试，还是在云服务器（如 AWS、GCP）上大规模部署，Clawmetry 都能为您提供如同“任务控制中心”般的洞察力，消除猜测，确保您的智能体始终在预定轨道上运行。

Clawmetry 的核心特性

1. 深度子智能体追踪 (Sub-Agent Tracking)

这是 Clawmetry 最核心的功能。当您的主智能体显示“正在派生子智能体”时，您不再需要盲目等待。Clawmetry 会展示每一个步骤：

• 正在读取哪些文件。
• 正在执行哪些指令。
• 正在调用哪些工具。
• 智能体的实时思考逻辑（Thinking Process）。
• 提供摘要、叙述性说明以及完整的日志记录。

2. 实时流程图 (Live Flow Graph)

通过可视化图表展示通道（Channels）、网关（Gateway）、模型（Models）、工具（Tools）和节点（Nodes）之间的连接关系。随着任务的推进，图表会实时更新，展示完整的执行流。

3. Token 与成本精确统计

Clawmetry 帮助您精准把控预算，提供关键的数据维度：

• 输入与输出 Token 统计。
• 缓存命中率（Cache Hits）。
• 响应延迟（Response Times）。
• 每次调用的具体成本（Cost per call）。

4. 全方位的成本分析

在收到账单前，先通过 Clawmetry 了解支出。支持按会话、按模型、按工具进行细化的成本拆解。

5. 系统健康度监测

实时监控后台任务（Cron jobs）、服务运行时间、磁盘使用率以及当前活跃的子智能体数量，一眼掌握系统状态。

6. 会话历史回溯

Clawmetry 会记录每一个会话的详细历史，包括完整的时间轴、工具调用路径和对应成本，方便开发者随时复盘和优化。

Clawmetry 的应用场景 (Use Case)

• 调试复杂流程： 当 OpenClaw 智能体陷入死循环或输出异常时，利用 Clawmetry 定位是哪个子智能体或哪个工具调用出现了问题。
• 预算管理与优化： 通过观察不同模型和工具的 Token 消耗，优化提示词（Prompts）以降低运营成本。
• 生产环境监控： 在服务器或云端部署 OpenClaw 时，作为运维看板确保系统高可用性。
• 性能调优： 识别响应延迟较高的节点，优化 OpenClaw 的执行效率。

如何安装 Clawmetry (How to Install)

Clawmetry 的安装极其简便，支持 macOS、Linux 和 Windows (WSL) 环境。安装程序会自动识别您的操作系统并完成配置。

快速开始 (一键安装)

只需在终端执行以下命令即可：

curl -fsSL https://clawmetry.com/install.sh | bash

此外，您也可以通过以下平台进行部署或获取支持：

• Pip: 适用于 Python 环境。
• PowerShell / CMD: 适用于 Windows 系统。
• GitHub: 欢迎在 GitHub 上 Star 我们的项目并关注最新进展。

兼容性与运行环境

Clawmetry 遵循“随处运行”的原则。只要能运行 OpenClaw 的地方，就能运行 Clawmetry：

• 本地端： macOS, Windows WSL, 笔记本电脑。
• 服务器： Ubuntu, Debian, Digital Ocean, Hostinger, Hetzner。
• 云平台： AWS, GCP。
• 边缘计算： Raspberry Pi (树莓派)。

常见问题解答 (FAQ)

Q: Clawmetry 是收费的吗？ A: 不。Clawmetry 是开源项目，遵循 MIT 开源协议，承诺永久免费。

Q: 安装 Clawmetry 会影响 OpenClaw 的性能吗？ A: Clawmetry 设计极其轻量，旨在提供实时观测性的同时，将系统资源占用降至最低。

Q: 我可以监控多个 OpenClaw 实例吗？ A: 是的，Clawmetry 整合了 Mission Control 任务系统，可以协助您管理和监控不同的代理任务。

Q: Clawmetry 是否支持 Windows？ A: 支持。您可以通过 Windows WSL 或 CMD/PowerShell 环境轻松完成安装。