ClawTrace

ClawTrace 是什麼？

ClawTrace 為 OpenClaw 代理提供可觀測性。它幫助您了解代理執行期間發生了什麼—什麼失敗了、成本在哪裡增加，以及下一步該做什麼—以改善可靠性並降低支出。

該產品結合執行級視圖與 LLM 呼叫、工具使用及子代理委派的詳細追蹤。它還包含「Tracy」，一個互動代理，能分析即時執行資料並提供情境感知的建議。

主要功能

• 互動式執行追蹤（含酬載的追蹤樹）： 檢查執行中的每個 LLM 呼叫、工具使用及子代理委派，以找出問題所在。
• 執行及步驟成本可見度： 查看代理執行中的支出變化，並深入步驟級成本飆升，找出預算外洩點。
• 失敗診斷與可能根本原因浮現： 追蹤不穩定行為，並突顯可能原因及改善建議。
• 圖形級關係映射（呼叫圖）： 可視化代理、工具及模型在完整軌跡中的關係。
• 時間軸瓶頸與並行視圖： 使用甘特圖式時間軸找出瓶頸並了解步驟間並行性。
• 軌跡儀表板用於監控： 查看所有軌跡的指標、日趨勢、權杖使用量及執行級深入分析。
• 「Tracy」診斷代理用於引導分析： 詢問執行失敗原因、瓶頸位置或降低成本方法；Tracy 會適應您查看的頁面/情境。
• 即時資料回應： 回應來自即時資料，而非過時儀表板或延遲報告。
• 對話後續追問： Tracy 記住對話，並可透過後續問題深入挖掘。

如何使用 ClawTrace

1. 在您的 OpenClaw 代理安裝 ClawTrace 外掛： openclaw plugins install @epsilla/clawtrace。
2. 使用您的觀測金鑰驗證： openclaw clawtrace setup。
3. 重新啟動閘道： openclaw gateway restart。
4. 如常執行您的代理： 軌跡會自動串流至 ClawTrace，您可即時檢查追蹤、區段、權杖及成本。
5. 使用 Tracy 進行診斷與建議： 詢問失敗、瓶頸或成本降低問題，然後後續追問以精煉分析。

使用案例

• 除錯不穩定的 OpenClaw 代理： 當行為不一致時，使用執行追蹤及追蹤樹導航找出可能根本原因，並查看改善可靠性的動作。
• 調查成本飆升： 若成本意外上升，檢查代理執行及步驟支出，找出驅動權杖使用或支出增加的步驟。
• 消除低效迴圈： 當代理來回迴圈時，使用時間軸及呼叫圖找出進展停滯處及需調整的軌跡部分。
• 比較變更後的改善： 使用 Tracy 評估變更後的執行，例如切換更便宜模型或腳本化可重複步驟以保持執行穩定。
• 跨多軌跡的操作監控： 使用軌跡儀表板檢視日趨勢、權杖使用量及執行級深入分析，捕捉部署中的重複問題。

常見問題

• ClawTrace 適用於 OpenClaw 代理嗎？ 是的。網站特別描述 ClawTrace 為「OpenClaw 代理的可觀測性」，包含可安裝外掛及軌跡串流。

• Tracy 分析什麼？ Tracy 分析您查看的執行/軌跡情境，並回答執行失敗原因、瓶頸位置及降低成本方法。它使用即時資料。

• 追蹤及成本細節如何在 ClawTrace 中呈現？ ClawTrace 提供含酬載的互動追蹤樹，用於 LLM 呼叫、工具使用及子代理委派，並有代理執行及步驟支出視圖。

• 使用前需要設定整合嗎？ 是的。基本流程為安裝外掛、使用觀測金鑰驗證，並重新啟動 OpenClaw 閘道。

• 資料如何保持最新？ 網站指出 Tracy 的回應來自即時資料，無過時儀表板或延遲報告。

替代方案

• 通用 LLM 可觀測性/遙測工具： 這些工具可提供 LLM 呼叫的日誌、追蹤和 token/成本指標，但可能無法提供 OpenClaw 專屬的軌跡檢視，例如呼叫圖關係和 Tracy 風格診斷。
• LLM 工作流程的開源追蹤框架： 若您已有追蹤管道，可建置自訂儀表板和除錯檢視，用於代理步驟和工具呼叫，但將失去「執行失敗 → 可能根本原因 → 下一步修正」的即用工作流程。
• 工作流程監控與分析儀表板： 針對專注營運指標（延遲、吞吐量、錯誤率）的團隊，分析工具可協助偵測問題，但可能無法提供具酬載可見度和互動軌跡鑽取的步驟級執行追蹤。