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 代理執行環境，並提供統一的即時視圖，展示其活動、成本、上下文使用與健康狀態，支援可選的安全審核與雲端同步，按節點收取合理費用。