ClawTrace

ClawTrace 是什么？

ClawTrace 为 OpenClaw 代理提供可观测性。它帮助您了解代理运行过程中发生了什么——什么失败了、成本在哪里增加、下一步该做什么——从而提升可靠性和降低支出。

该产品结合了运行级视图和 LLM 调用、工具使用以及子代理委派的详细追踪。它还包括“Tracy”，一个交互式代理，用于分析实时运行数据并提供上下文感知的推荐。

主要功能

• 交互式执行追踪（带负载的追踪树）： 检查运行中的每个 LLM 调用、工具使用和子代理委派，以精确定位问题发生的位置。
• 按运行和步骤的成本可见性： 查看代理运行中支出的变化，并深入分析步骤级成本飙升，找出预算泄漏点。
• 故障诊断和潜在根本原因浮现： 追踪不稳定行为，并突出显示潜在原因以及改进建议。
• 图级关系映射（调用图）： 可视化代理、工具和模型在整个轨迹中的关系。
• 时间线瓶颈和平行视图： 使用甘特图风格的时间线发现瓶颈并理解步骤间的并行性。
• 轨迹监控仪表板： 查看所有轨迹的指标、日趋势、令牌使用量和运行级深入分析。
• “Tracy” 医生代理用于引导分析： 询问运行为什么失败、瓶颈在哪里或如何降低成本；Tracy 会根据您查看的页面/上下文进行适应。
• 实时数据响应： 回答基于实时数据生成，而非陈旧仪表板或延迟报告。
• 对话跟进： Tracy 记住对话，并可通过跟进问题深入挖掘。

如何使用 ClawTrace

1. 在您的 OpenClaw 代理上安装 ClawTrace 插件：openclaw plugins install @epsilla/clawtrace。
2. 使用您的 observe key 进行认证：openclaw clawtrace setup。
3. 重启网关：openclaw gateway restart。
4. 正常运行您的代理：轨迹会自动流式传输到 ClawTrace，您可以实时检查追踪、跨度、令牌和成本。
5. 使用 Tracy 进行诊断和推荐：询问关于故障、瓶颈或成本降低的问题，然后跟进以细化分析。

使用场景

• 调试不稳定的 OpenClaw 代理： 当行为不一致时，使用执行追踪和追踪树导航找出潜在根本原因，并查看提升可靠性的操作。
• 调查成本飙升： 如果成本意外上升，检查代理运行和步骤的支出，找出驱动令牌使用或支出增加的步骤。
• 消除低效循环： 当代理来回循环时，使用时间线和调用图找出进度停滞的位置以及轨迹中需要调整的部分。
• 比较变更后的改进： 使用 Tracy 评估应用变更后的运行，例如切换到更便宜的模型或脚本化可重复步骤以保持运行更稳定。
• 跨多个轨迹的操作监控： 使用轨迹仪表板审查日趋势、令牌使用量和运行级深入分析，以捕获部署中的重复问题。

常见问题

• ClawTrace 支持 OpenClaw 代理吗？ 是的。网站特别将 ClawTrace 描述为“OpenClaw 代理的可观测性”，包括可安装插件和轨迹流式传输。

• Tracy 分析什么？ Tracy 分析您查看的运行/轨迹上下文，并回答关于运行为什么失败、瓶颈在哪里以及如何降低成本的问题。它使用实时数据。

• ClawTrace 中追踪和成本细节如何显示？ ClawTrace 提供带负载的交互式追踪树，用于 LLM 调用、工具使用和子代理委派，并有按代理运行和步骤的支出视图。

• 使用前需要设置集成吗？ 是的。列出的基本流程是安装插件、使用 observe key 认证并重启 OpenClaw 网关。

• 数据如何保持最新？ 网站指出 Tracy 的回答来自实时数据，没有陈旧仪表板或延迟报告。

替代方案

• 通用 LLM 可观测性/遥测工具： 这些工具可提供 LLM 调用日志、追踪和令牌/成本指标，但可能无法提供 OpenClaw 专属轨迹视图，如调用图关系和 Tracy 式诊断。
• LLM 工作流开源追踪框架： 如果已有追踪管道，您可构建自定义仪表板和代理步骤及工具调用的调试视图，但将丢失开箱即用的“运行失败 → 可能根本原因 → 后续修复”工作流。
• 工作流监控和分析仪表板： 对于关注运营指标（延迟、吞吐量、错误率）的团队，分析工具可帮助检测问题，但可能无法提供带负载可见性和交互式轨迹钻取的步骤级执行追踪。