vivekchand/clawmetry

ClawMetry 的功能

ClawMetry 是一个本地仪表盘，用于监控 AI 编码代理已写入的会话日志。通过读取这些只读文件，它构建了每次工具调用、令牌使用和成本的完整时间线，让您一目了然地看到代理是在取得进展还是只是永远循环。

它开箱即用——您只需安装 Python 包并运行 clawmetry。该程序会在 http://localhost:8900 启动一个 Web UI，并自动发现机器上支持的 33 种代理运行时（例如 Claude Code、OpenAI Codex、Cursor、OpenClaw、NVIDIA NemoClaw 等）。无需更改代码、导入 SDK 或进行任何插桩。

---

核心功能

功能	您看到的内容	获取方式
会话回放	带有时间戳、工具调用和模型回复的逐步记录。	读取运行时的会话文件（只读）。
成本与令牌明细	每个代理、每个模型的每日、每周、每月支出，并带有异常标记。	解析每个运行时暴露的令牌计数和定价数据。
流程图	显示消息从 user → gateway → model → tools 流动的实时图。	从相同的会话日志构建；无额外网络流量。
上下文窗口使用量	每个提供商的上下文窗口百分比、压缩事件、溢出警告。	使用内置的提供商特定窗口大小表（Anthropic、OpenAI、Google 等）。
内存/技能加载	每个代理实际加载的文件和“技能”。	从运行时元数据中提取。
健康与警报	磁盘/内存使用量、速率限制命中、错误峰值、预算上限；可推送到 Slack、Discord、PagerDuty、Telegram、Email。	本地监控；可选出站 webhook。
审批	暂停高风险工具调用（例如 sudo、机密泄露）并从手机批准/拒绝。	需要可选的强制代理；默认关闭。
SDK 跟踪	如果您在 LangChain、Pydantic-AI 等上构建代理，ClawMetry 可以将 LLM 调用归因于您的代码。	通过可启用的拦截器（CLAWMETRY_INTERCEPT=1）。

---

使用方法

1. 安装 – pip install clawmetry（Python 3.8+）。
2. 运行 – clawmetry 启动守护进程并打开 UI。
3. 浏览 – 标题栏允许您在运行时之间切换；每个选项卡显示上述视图。
4. （可选）连接 – clawmetry connect 将加密快照上传到云端以便远程查看；否则所有内容都保留在您的机器上。

如果您还没有代理，clawmetry --sample 会加载三个合成会话，以便您探索 UI。

---

定价与许可

• 免费层 – 在本地与 OpenClaw、NVIDIA NemoClaw、Goose 和 Qwen Code 一起使用。数据不会离开盒子。
• Starter（$9 / 节点 / 月） – 添加其他 28 个运行时和快照的云同步。
• Pro（$19 / 节点 / 月） – 添加审批、策略引擎、异常检测、成本优化器、OpenTelemetry 导出、防篡改审计日志等。

所有层级均为 MIT 许可源代码；付费功能通过闭源伴侣（clawmetry-pro）提供。

---

数据隐私与网络流量

• 默认情况下，不会向任何地方发送任何会话内容。
• 唯一的出站调用是匿名安装 ping、PyPI 版本检查以及用于横幅的一次性公共 IP 查询。
• 两者都可以选择退出，并在 docs/EGRESS.md 中有文档说明。
• 当您显式运行 clawmetry connect 时，快照是端到端加密的；解密在浏览器中使用一个静态 JS 文件完成，其完整性经过验证。

---

性能影响

插桩点	增加延迟（典型）	默认状态
会话文件跟踪	0 毫秒（独立进程）	开启
HTTP 拦截器	每次 LLM 调用 +0.44 毫秒	关闭
工具前钩子门	每次门控调用 +44 毫秒	关闭
强制代理	每次 LLM 调用 +9.7 毫秒	关闭

守护进程本身使用约 CPU 核心的 12% 和磁盘上每 10 万事件约 70 KB。基准测试在 benchmarks/overhead.py 中提供。

---

谁可能受益？

• 运行多个编码代理的开发者（例如，在 CI 服务器或个人工作站上），需要一个单一界面来发现卡住的循环、成本超支或高风险工具使用。
• 希望强制执行预算上限或要求危险操作获得手动批准的团队负责人。
• 在无需修改代码的情况下比较不同代理运行时行为的研究人员。

---

限制与注意事项

• 仪表盘只能显示每个运行时实际记录的数据；某些运行时不暴露成本信息，这反映在兼容性矩阵中。
• 上下文窗口百分比是根据提供商特定的窗口大小计算的；如果运行时使用的模型窗口大于表格条目，百分比可能显得过高。
• 审批和策略强制执行需要可选的代理组件，该组件默认关闭。
• 免费层仅支持四个运行时；其余需要付费计划或 clawmetry-pro 伴侣。

---

快速入门片段

pip install clawmetry               # 安装包
clawmetry                           # 启动守护进程并打开 UI
# 如果您还没有代理：
clawmetry --sample                  # 加载合成会话用于演示

---

了解更多

• 文档 – docs/ 包含有关兼容性、上下文膨胀、开销、审批、OpenTelemetry 导出以及如何添加自己的代理运行时的详细指南。
• 截图 – README 包含几个显示成本明细、流程图、警报和质量等级的截图。
• 定价 – 完整定价表请访问 https://clawmetry.com/pricing。

ClawMetry 本质上是一个针对 AI 编码代理的监控和可观测性层，在无需对代理本身进行任何更改的情况下，为您提供可见性、成本意识以及安全控制。