ClawTrace

ClawTraceとは？

ClawTraceはOpenClawエージェントの可観測性を提供します。エージェント実行中に何が起こったかを理解する手助けをします—何が失敗したか、どこでコストが増加したか、次に何を変えるか—信頼性を向上させ、支出を削減するために。

製品は実行レベルのビューとLLM呼び出し、ツール使用、サブエージェント委譲の詳細トレースを組み合わせています。また、ライブ実行データを分析し、文脈に応じた推奨を提供するインタラクティブエージェント「Tracy」を含みます。

主な機能

• インタラクティブ実行トレース（ペイロード付きトレーストリー）: 実行内のLLM呼び出し、ツール使用、サブエージェント委譲をすべて検査し、問題が発生した箇所を特定。
• 実行・ステップ別コスト可視化: エージェント実行全体での支出変動を確認し、ステップレベルのコスト急増を掘り下げて予算漏れ箇所を特定。
• 障害診断と原因特定: 不安定な動作をトレースし、可能性の高い原因を強調し、改善アクションを提案。
• グラフレベルの関係マッピング（コールグラフ）: エージェント、ツール、モデルの全体軌跡での関係を可視化。
• タイムラインボトルネック・並列ビュー: ガントチャート形式のタイムラインでボトルネックを特定し、ステップ間の並列性を理解。
• 監視用軌跡ダッシュボード: メトリクス、日次トレンド、トークン使用量、実行レベルの詳細ドリルダウンを全軌跡で表示。
• 分析ガイド「Tracy」ドクターエージェント: 実行失敗の理由、ボトルネック箇所、コスト削減方法を質問；Tracyは表示中のページ/文脈に適応。
• ライブデータ応答: 古いダッシュボードや遅延レポートではなく、ライブデータから回答生成。
• 会話フォローアップ: Tracyは会話を記憶し、フォローアップ質問で深掘り可能。

ClawTraceの使い方

1. OpenClawエージェントにClawTraceプラグインをインストール: openclaw plugins install @epsilla/clawtrace。
2. observeキーで認証: openclaw clawtrace setup。
3. ゲートウェイを再起動: openclaw gateway restart。
4. 通常通りエージェントを実行: 軌跡が自動的にClawTraceにストリーミングされ、トレース、スパン、トークン、コストをリアルタイムで検査可能。
5. 診断と推奨にTracyを使用: 失敗、ボトルネック、コスト削減について質問し、分析を洗練するためのフォローアップ。

ユースケース

• 不安定なOpenClawエージェントのデバッグ: 動作が不安定になった場合、実行トレースとトレーストリーナビゲーションで原因を特定し、信頼性向上アクションを表示。
• コスト急増の調査: 予期せぬコスト上昇時、エージェント実行・ステップ別の支出を検査し、トークン使用や支出増加の原因ステップを特定。
• 非効率ループの排除: エージェントが往復ループする場合、タイムラインとコールグラフで進捗停滞箇所と軌跡調整箇所を特定。
• 変更後の改善比較: 低コストモデルへの切り替えや繰り返しステップのスクリプト化などの変更適用後、Tracyで実行を評価し安定性を向上。
• 多数軌跡の運用監視: 軌跡ダッシュボードで日次トレンド、トークン使用量、実行レベルの詳細を確認し、デプロイ全体の再発問題を検知。

FAQ

• ClawTraceはOpenClawエージェントに対応していますか？ はい。サイトではClawTraceを「OpenClawエージェントの可観測性」と明記し、インストール可能プラグインと軌跡ストリーミングを記載。

• Tracyは何を分析しますか？ 表示中の実行/軌跡文脈を分析し、実行失敗の理由、ボトルネック箇所、コスト削減方法に回答。ライブデータを使用。

• ClawTraceでトレースとコスト詳細はどう表示されますか？ LLM呼び出し、ツール使用、サブエージェント委譲のペイロード付きインタラクティブトレーストリーと、エージェント実行・ステップ別支出ビューを提供。

• 使用前にインテグレーション設定が必要ですか？ はい。基本ワークフローはプラグインインストール、observeキー認証、OpenClawゲートウェイ再起動。

• データは最新状態を保ちますか？ サイトではTracyの回答がライブデータ由来で、古いダッシュボードや遅延レポートなしと記載。

代替案

• 汎用LLM可観測性/テレメトリツール： LLM呼び出しのログ、トレース、トークン/コストメトリクスを提供できますが、OpenClaw特有の実行経路ビュー（コールグラフ関係やTracyスタイル診断）を提供しない場合があります。
• LLMワークフローのオープンソーストレーシングフレームワーク： 既存のトレーシングパイプラインをお持ちの場合、エージェントステップやツール呼び出し用のカスタムダッシュボードとデバッグビューを構築できますが、「実行失敗 → 推定根本原因 → 次の修正」という即時利用可能なワークフローを失います。
• ワークフローモニタリングおよびアナリティクスダッシュボード： 運用メトリクス（レイテンシ、スループット、エラー率）に注力するチーム向けに、問題検知に役立ちますが、ペイロード可視性とインタラクティブな実行経路ドリルダウン付きのステップレベル実行トレースを提供しない場合があります。