clawmetry

技能简介

clawmetry 是一款零配置的 AI 智能体运行时可观测性工具，一个仪表盘同时覆盖 31 种 AI 编码智能体的运行状态。它通过直接读取各智能体运行时已经写入的会话文件（纯只读，不修改任何内容），将时间线、工具调用、token 消耗和费用数据汇聚到统一视图，让用户能够一眼分辨长时运行的任务是在正常推进还是在空转打转。

核心能力

• 31 种运行时全覆盖：支持 OpenClaw、NVIDIA NemoClaw、Claude Code、OpenAI Codex、Cursor、GitHub Copilot、Gemini CLI、Cline、OpenHands、Lovelace、Replit、Muse Code、OpenCode、Aider、Goose、Qwen Devin、Kimi、Grok、n8n、AntGravity、DeepSeek、Hermes、Exo、Grok-bot、NanoCreek、MicroCreek、MoltBot 等
• 零配置安装：pip install clawmetry && clawmetry 一条命令搞定，无需任何 SDK 集成或代码修改
• 纯只读读取：仅读取智能体已有的会话文件，不在应用中注入任何代码，不改变智能体原有运行方式
• 实时仪表盘：在 http://localhost:8900 提供 Web UI，实时展示各智能体的会话时间线、工具调用记录、token 和费用分解
• 循环/失败信号检测：自动识别工具调用循环、重复失败等异常轨迹（trajectory signals）
• Token 与费用追踪：按运行时汇总 token 消耗和费用，支持 24 小时和全生命周期两个维度
• 多语言文档：提供简体中文、日语、韩语、西班牙语、葡萄牙语、法语、德语等 10+ 语言文档
• 开源 MIT 许可：核心开源，OpenClaw/Goose/本地模型免费使用无账户无 Key

安装配置

前置条件：

• Python 3.10+
• pip（包管理器）
• 已安装至少一种受支持的 AI 编码智能体

安装步骤：

1. 通过 pip 安装：pip install clawmetry
2. 直接运行：clawmetry
3. 浏览器打开 http://localhost:8900 即可看到仪表盘

免费功能：

• OpenClaw、NVIDIA NemoClaw、Goose：完全免费，无需账户和 Key，无需网络请求
• 其他 27 种运行时（包括 Claude Code、Codex、Cursor 等）：需安装 clawmetry-pro 配套组件（7 天试用或付费计划）

配置文件（如需）： 配置文件位于 ~/.clawmetry/config.json，可自定义监听端口、日志级别等参数。

使用步骤

1. 安装 clawmetry：pip install clawmetry
2. 启动仪表盘：clawmetry（默认监听 http://localhost:8900）
3. 打开浏览器：访问 http://localhost:8900 查看所有已检测到的智能体列表
4. 选择运行时：在左侧列表中选择要查看的特定智能体
5. 查看时间线：在主面板查看该智能体的完整会话时间线、工具调用序列
6. 分析 token 消耗：查看本次运行的 token 和费用明细
7. 识别异常信号：观察是否出现循环调用、重复失败等告警标记

适用场景

• 多智能体运维：同时运行多个 AI 编码智能体的团队，监控所有智能体的健康状态
• Token 费用审计：追踪每个智能体每次运行的 token 消耗，控制 AI 使用成本
• 问题诊断：快速定位某个智能体是在正常推理还是在循环空转，减少无效等待
• 性能对比：对比不同模型/智能体在相同任务上的 token 效率和运行时间
• CI/CD 集成：在自动化流水线中监控 AI 编码任务是否陷入死循环
• 团队协作：运维人员无需进入开发者环境，即可通过 Web 仪表盘查看所有 AI 任务的实时状态

适用人群

• 同时使用多个 AI 编码智能体的开发团队
• 需要监控 AI Token 消耗和费用的管理者
• DevOps 工程师（AI 任务稳定性保障）
• AI 平台运维人员
• 大型 AI 项目项目经理（实时掌握任务进度）

工作原理

clawmetry 的工作原理分为三个阶段：

1. 智能体检测：启动时自动扫描本地环境中已安装的 AI 编码运行时，识别支持的智能体类型
2. 会话文件读取：定时轮询各智能体的会话文件（纯只读），解析其中的工具调用序列、token 消耗、时间戳等信息
3. 数据聚合与可视化：将读取的数据存入本地内存（无需数据库），通过 Web 仪表盘实时渲染时间线、调用链和费用统计

关键设计原则：所有读取操作均为只读，不修改智能体运行时的任何状态，不在目标应用中注入任何 SDK 或监控代码。

官方链接

• PyPI：https://pypi.org/project/clawmetry/
• GitHub：https://github.com/vivekchand/clawmetry
• 文档：https://github.com/vivekchand/clawmetry/blob/main/README.md
• 支持的运行时列表：https://github.com/vivekchand/clawmetry/blob/main/SUPPORTED_RUNTIMES.txt
• 费用说明：https://github.com/vivekchand/clawmetry/blob/main/docs/ENTITLEMENTS.md