vivekchand/clawmetry

🦞 ClawMetry – AI 代理人的实时可观测性

是什么 – 一个本地运行的仪表板，可自动发现机器上安装的 AI 代理运行时（例如 OpenClaw、NVIDIA NemoClaw、Claude Code、OpenAI Codex 等），并实时显示每个代理的运行情况、成本以及是否存在异常。

为何重要 – 当你运行多个自主代理时，很快就会失去对以下信息的可见性：

• 哪些 LLM 调用正在发生，
• 每次调用消耗了多少 token 和美元，
• 工具调用是否具有风险，
• 代理是否卡住或超出了上下文窗口。 ClawMetry 在不修改代理本身的情况下，通过单一 UI 将所有这些信息呈现出来。

---

主要功能（如 README 所述）

功能	你将获得
自动发现	一键安装（pip install clawmetry && clawmetry）可发现主机上支持的 30 种运行时，并以只读方式读取其会话文件。
会话与转录	逐轮查看每个代理的对话，并带有回放按钮。
成本与 token 追踪	按运行时、按模型、按天和终身支出，以及异常峰值标记。
实时流程图	可视化消息在通道、模型和工具之间流动的图形，随代理运行实时更新。
上下文窗口监控	显示窗口利用率、压缩事件和“爆破”警告，使用供应商特定的窗口表。
内存与技能视图	列出每个运行时加载的文件和技能。
健康与日志	磁盘/内存使用量、错误率、速率限制状态、实时日志流。
警报与审批	内置检测器（成本激增、静默代理、错误爆发等）和可选的风险工具调用审批，可通过手机批准。
导出	支持 OpenTelemetry (OTLP)，可将追踪发送到外部后端。
SDK 追踪	如果你基于 SDK 构建代理，拦截器可将 LLM 调用归因到你自己的代码。

---

支持的运行时（免费 vs 付费）

• 免费开源运行时 – OpenClaw、NVIDIA NemoClaw、Goose。
• 付费运行时 – Claude Code、Cursor、GitHub Copilot、OpenAI Codex、Gemini CLI、Replit Agent、OpenHands 等（总计超过 30 个代理）。

---

定价与部署

计划	覆盖范围	价格（每节点）
免费	仅支持三个开源运行时，本地专用仪表板。	$0
入门版	所有运行时，集群视图，云同步。	$9 / 月
专业版	入门版 + 审批、策略引擎、评估工具、异常检测、成本优化、OTel 导出、防篡改审计日志。	$19 / 月

自托管许可证密钥可让你在不使用 SaaS 组件的情况下运行付费功能（clawmetry license）。

---

数据隐私与出站流量

• 默认情况下，ClawMetry 读取本地会话文件；除非你运行 clawmetry connect，否则不会将会话数据发送到机器外。
• 可选的 connect 流程在浏览器中进行端到端加密；加密密钥永远不会离开主机。
• 无选项退出的唯一出站流量是匿名安装 ping、PyPI 版本检查，以及用于横幅的一次性公网 IP 查询。
• 所有出站目的地均在 docs/EGRESS.md 中记录，可禁用。

---

性能影响

• 守护进程作为独立进程运行；会话文件尾部追踪增加 0 ms。
• 可选 HTTP 拦截器每 LLM 调用增加 ≈0.44 ms（≈5 秒调用的 0.009%）。
• 可选预工具钩子每受控工具调用增加 ≈44 ms。
• 强制代理每 LLM 调用增加 ≈9.7 ms。
• 在繁忙安装中，守护进程消耗约 1 个 CPU 核心的 12%，每 10 万事件约 70 MB。
• 可通过 python -m benchmarks.overhead 本地测量开销。

---

安装与快速入门

pip install clawmetry      # 安装 Python 包
clawmetry                  # 在 http://localhost:8900 启动仪表板

• 支持 Python 3.8+ 的 macOS、Linux 或 Windows。
• 提供 Docker 镜像和 Compose 文件（docs/DOCKER.md）。

---

文档亮点

• 兼容性 – 每个适配器读取的内容及如何添加新运行时。
• 上下文爆破 – 各供应商的窗口大小、压缩 vs 溢出。
• 开销 – 详细的基准测试方法。
• 审批与策略 – 风险评分和手机审批流程。
• OpenTelemetry – 将追踪导出到任何 OTLP 收集器。
• SDK 追踪 – 为自建代理分配成本。

---

许可证

MIT – 免费使用、修改和重新分发。

---

TL;DR

ClawMetry 是一个自托管的可观测性平台，可自动发现你机器上的多种 AI 代理运行时，并提供统一的实时视图，展示其活动、成本、上下文使用和健康状况，支持可选的安全审批和云同步，按节点收取合理费用。