ClawMetry for NVIDIA NemoClaw

ClawMetry 是什么？

ClawMetry for NVIDIA NemoClaw 为 NemoClaw 沙箱提供实时结构化可观测性。不再仅依赖 NemoClaw 的终端 UI，它会收集并持久化活动数据，如工具调用、Token 使用量、内存文件变更以及定时（cron）任务状态。

目标是帮助您了解整个 NemoClaw 集群中代理在运行时的行为，通过 Web 仪表板进行实时查看。ClawMetry 还会从您的主机执行端到端加密云同步，将遥测数据作为加密流发送。

主要特性

• 主机一键部署，实现集群覆盖：在运行 NemoClaw 的主机上执行单个安装命令，即可为每个沙箱实例应用网络策略预设并开始同步。
• 端到端加密遥测数据上传云端：主机上生成加密密钥；仅加密遥测流到达 ClawMetry Cloud，提示词/响应和 API 密钥不会明文发送。
• 实时代理活动及每次调用详情：通过 Web 仪表板实时查看工具调用、Token 消耗以及子代理生成活动。
• 关键文件内存监控：监控 SOUL.md 和 MEMORY.md 的意外变更，早起检测潜在内存损坏。
• Token 成本追踪：追踪每次调用 Token 成本、日总计及月度预测。
• 定时任务监控：无需阅读日志或 SSH 进入实例，即可查看 cron 执行历史，包括上次运行、下次运行及失败情况。
• Web 访问实时会话：通过浏览器访问 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 中运行，您可以通过提示如“Help me install in a long running 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 记账。