ClawMetry for NVIDIA NemoClaw

ClawMetry 是什麼？

ClawMetry for NVIDIA NemoClaw 為 NemoClaw 沙箱提供即時結構化可觀測性。不再僅依賴 NemoClaw 的終端 UI，它會收集並持久化活動資料，例如工具呼叫、token 使用量、記憶體檔案變更，以及排程 (cron) 工作狀態。

目標是幫助您了解 NemoClaw 叢集執行時代理程式的行為，並透過網頁儀表板即時檢視。ClawMetry 也從主機執行端對端加密雲端同步，將遙測資料以加密串流傳送。

主要功能

• 主機一鍵部署覆蓋叢集：在執行 NemoClaw 的主機上運行單一安裝指令，即可對每個沙箱實例套用網路政策預設並開始同步。
• 端對端加密遙測至雲端：主機上產生加密金鑰；僅加密遙測串流傳至 ClawMetry Cloud，提示/回應及 API 金鑰不會明文傳送。
• 即時代理活動與每次呼叫細節：從網頁儀表板即時查看工具呼叫、token 消耗及子代理啟動活動。
• 關鍵檔案記憶體監控：監控 SOUL.md 和 MEMORY.md 的意外變更，早日偵測潛在記憶體損壞。
• Token 成本追蹤：追蹤每次呼叫 token 成本、日總計及月預測。
• Cron 工作監控：查看 cron 執行歷史，包括上次執行、下次執行及失敗，不需讀取日誌或 SSH 至實例。
• 網頁存取即時工作階段：從瀏覽器存取 app.clawmetry.com 監控即時代理工作階段及狀態（行動版標示「即將推出」）。
• 與 OpenShell 守護欄並行運行：ClawMetry 設計用於觀測代理活動，不會繞過沙箱政策。

如何使用 ClawMetry

1. 在 NemoClaw 主機安裝：在執行 NemoClaw 的主機上執行單行安裝器：curl -fsSL https://clawmetry.com/install.sh | bash。
2. 讓 ClawMetry 套用政策並開始同步：安裝器會自動對所有沙箱套用網路政策預設，並啟動加密雲端同步。
3. 開啟儀表板觀測活動：使用 app.clawmetry.com 查看即時工作階段、每次呼叫 token 消耗、記憶體檔案差異及 cron 工作狀態。

若 NemoClaw 代理已在長時間執行的 PTY 中運行，您可提示它安裝，例如：「幫我在長時間 PTY 中安裝…」。代理會下載安裝器、設定 ClawMetry、連線您的節點，並自動開始同步。

使用案例

• 叢集範圍代理行為除錯：從單一雲端儀表板監控多個 NemoClaw 沙箱的工具呼叫、token 消耗及子代理啟動事件。
• LLM 使用預算可見度：追蹤每次呼叫 token 成本，並彙整為日總計及月預測，了解成本累積位置。
• 早期偵測代理記憶體損壞：持續監控 SOUL.md 和 MEMORY.md 的變更，在下游問題發生前發現意外更新。
• 排程任務營運監控：從儀表板追蹤 cron 執行結果（上次執行、下次執行及失敗），而非檢查每個節點日誌。
• 具安全守護欄的監控：在 OpenShell 安全層旁觀測代理活動，不嘗試繞過沙箱政策。

常見問題

ClawMetry 相容 OpenShell 守護欄嗎？

是的。文件指出 ClawMetry 可觀測性與 NemoClaw 安全層並行運行，且設計不繞過沙箱政策。

資料傳至雲端時如何保護？

ClawMetry 在主機產生加密金鑰，並傳送加密遙測串流至 ClawMetry Cloud。提示、回應及 API 金鑰不會明文離開您的機器。

儀表板可看到什麼？

從 app.clawmetry.com 查看即時代理工作階段、每次呼叫 token 消耗、SOUL.md 和 MEMORY.md 檔案差異，以及 cron 工作狀態。

每個 NemoClaw 實例都需要獨立設定嗎？

描述的工作流程為主機基礎：在 NemoClaw 主機運行安裝器，即可一次覆蓋所有 NemoClaw 實例。

若已有長時間執行的 NemoClaw 代理呢？

您可要求現有代理在長時間 PTY 中安裝 ClawMetry；它會下載安裝器、設定 ClawMetry、連線您的節點，並開始同步。

替代方案

• 僅依賴 NemoClaw 的終端機/UI (TUI)：這保持觀測本地且暫時性（僅限終端機），但缺乏 ClawMetry 所述的結構化、持久化歷史記錄、雲端儀表板存取，以及全艦隊視圖。
• 針對代理工具呼叫建置自訂記錄/遙測：你可以為代理執行階段加入儀表化，記錄工具呼叫、token 與事件，但需自行實作持久化、儀表板與加密傳輸。
• 通用基礎設施可觀測性（指標/記錄/APM）：此類工具著重主機/服務指標與記錄；它們可能無法開箱即用提供 NemoClaw 專屬可見性，例如記憶檔差異（SOUL.md、MEMORY.md）或每個代理的工具呼叫 token 計費。