OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

軌跡バンドル

Trajectory キャプチャは、OpenClaw のセッション単位のフライトレコーダーです。各エージェント実行の 構造化されたタイムラインを記録し、/export-trajectory が現在のセッションを、 以下を含む機密情報削除済みのサポートバンドルとしてパッケージ化します。

  • モデルに送信されたプロンプト、システムプロンプト、ツール
  • どのトランスクリプトメッセージとツール呼び出しが回答につながったか
  • 実行がタイムアウト、中止、Compaction、またはプロバイダーエラーに遭遇したか
  • どのモデル、plugins、skills、ランタイム設定が有効だったか
  • プロバイダーが返した使用量とプロンプトキャッシュのメタデータ

広範な Gateway サポートレポートが必要な場合は、代わりに /diagnostics から始めてください。これは、 サニタイズ済みの Gateway バンドルを収集し、OpenAI Codex ハーネスセッションでは、 承認後に Codex のフィードバックを OpenAI に送信できます。セッション単位の詳細な プロンプト、ツール、トランスクリプトのタイムラインが必要な場合は、/export-trajectory を使用してください。

クイックスタート

アクティブなセッションで送信します（エイリアスは /trajectory）。

text
/export-trajectory

OpenClaw はワークスペース内の次の場所にバンドルを書き込みます。

text
.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/

上書きするには、相対出力ディレクトリ名を渡します。

text
/export-trajectory bug-1234

名前は .openclaw/trajectory-exports/ 内で解決されます。絶対パスおよび ~ パスは拒否されます。

Trajectory バンドルには、プロンプト、モデルメッセージ、ツールスキーマ、ツール 結果、ランタイムイベント、ローカルパスが含まれる可能性があるため、チャットコマンドは 常に exec 承認を経由します。バンドルを作成する意図がある場合に限り、エクスポートを 一度承認してください。すべて許可は使用しないでください。グループチャットでは、OpenClaw は Trajectory の詳細を共有ルームへ投稿せず、承認プロンプトとエクスポート結果を所有者に 非公開で送信します。

ローカルでの確認やサポートワークフローでは、基盤となる CLI コマンドを 直接実行します。

bash
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .

その他のフラグ：--output <path>（.openclaw/trajectory-exports 内の ディレクトリ名）、--store <path>（セッションストアの上書き）、 --agent <id>（ストア解決用のエージェント ID）、--json（構造化出力）。

アクセス

Trajectory のエクスポートは所有者コマンドです。送信者は、通常のコマンド認可チェックに 加えて、チャンネルの所有者チェックにも合格する必要があります。

記録される内容

OpenClaw のエージェント実行では、Trajectory キャプチャがデフォルトで有効です。

ランタイムイベントには以下が含まれます。

  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • model.fallback_step（移行元モデル、次のモデル、失敗理由／詳細、チェーン内の位置、およびチェーンが進行したか、成功したか、または尽きたかを含む）
  • model.completed
  • trace.artifacts
  • session.ended

トランスクリプトイベントは、アクティブなセッションブランチから再構築されます。対象は、 ユーザーメッセージ、アシスタントメッセージ、ツール呼び出し、ツール結果、Compaction、モデル 変更、ラベル、カスタムセッションエントリです。

イベントは、次のスキーママーカーを持つ JSON Lines として書き込まれます。

json
{  "traceSchema": "openclaw-trajectory",  "schemaVersion": 1}

バンドルファイル

ファイル 内容
manifest.json バンドルスキーマ、ソースファイル、イベント数、生成ファイル一覧
events.jsonl 順序付けされたランタイムとトランスクリプトのタイムライン
session-branch.json 機密情報削除済みのアクティブなトランスクリプトブランチとセッションヘッダー
metadata.json OpenClaw のバージョン、OS／ランタイム、モデル、設定スナップショット、plugins、skills、プロンプトメタデータ
artifacts.json 最終ステータス、エラー、使用量、プロンプトキャッシュ、Compaction 回数、アシスタントテキスト、ツールメタデータ
prompts.json 送信されたプロンプトと、選択されたプロンプト構築の詳細
system-prompt.txt キャプチャされている場合、最新のコンパイル済みシステムプロンプト
tools.json キャプチャされている場合、モデルに送信されたツール定義

manifest.json には、各バンドルに存在するファイルが一覧表示されます。セッションで 対応するランタイムデータがキャプチャされなかった場合、一部のファイルは省略されます。

キャプチャストレージ

ランタイムの Trajectory イベントは、セッションとともにエージェント単位の SQLite データベースに保存されます。Trajectory をエクスポートすると、機密情報削除済みの JSONL サポートバンドルが生成されます。稼働中のランタイムキャプチャは、セッションに隣接する JSONL サイドカーではありません。

古いリリースや明示的なレガシーファイルエクスポートによって、従来の .trajectory.jsonl および .trajectory-path.json ファイルが引き続き存在する場合が あります。セッションメンテナンスでは、これらのファイルをクリーンアップ対象として扱います。 アクティブなキャプチャはデータベース行を書き込みます。

キャプチャの無効化

bash
export OPENCLAW_TRAJECTORY=0

これにより、OpenClaw を起動する前にランタイムの Trajectory キャプチャが無効になります。 /export-trajectory は引き続きトランスクリプトブランチをエクスポートできますが、 コンパイル済みコンテキスト、プロバイダーアーティファクト、プロンプトメタデータなどの ランタイム専用データが欠落する場合があります。

フラッシュタイムアウトの調整

OpenClaw はエージェントのクリーンアップ中に、ランタイムの Trajectory 行をフラッシュします。 デフォルトのクリーンアップタイムアウトは 10,000 ms です。低速なディスクや大規模なストアでは、 OpenClaw を起動する前に OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS を設定してください。

bash
export OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS=30000

これは、OpenClaw が openclaw-trajectory-flush タイムアウトをログに記録して 処理を継続するタイミングを制御します。Trajectory のサイズ上限は変更しません。明示的な タイムアウトを渡さないすべてのエージェントクリーンアップ手順を調整するには、 OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS を設定します。

プライバシーと制限

Trajectory バンドルはサポートおよびデバッグ用であり、公開投稿用ではありません。OpenClaw は エクスポートファイルを書き込む前に、機密性の高い値を削除します。

  • 認証情報および既知のシークレットに類似するペイロードフィールド
  • 画像データ
  • ローカル状態パス
  • $WORKSPACE_DIR に置き換えられたワークスペースパス
  • 検出されたホームディレクトリパス

エクスポーターは入力サイズにも上限を設けます。

  • ランタイムキャプチャ：稼働中のキャプチャは 10 MiB を上限とするローリングウィンドウであり、新しいイベント用の領域を確保するために最も古いイベントを破棄します。エクスポートでは、最大 50 MiB の既存の従来型ランタイムサイドカーファイルを受け入れます
  • セッションファイル：50 MiB
  • エクスポートごとのランタイムイベント：200,000
  • エクスポートされるイベントの合計：250,000
  • 個々のランタイムイベント行は 256 KiB を超えると切り詰められます

チーム外に共有する前に、バンドルを確認してください。機密情報の削除はベストエフォートであり、 アプリケーション固有のすべてのシークレットを把握できるわけではありません。

トラブルシューティング

エクスポートにランタイムイベントが含まれない場合：

  • OpenClaw が OPENCLAW_TRAJECTORY=0 なしで起動されたことを確認する
  • セッションでもう一度メッセージを実行してから、再度エクスポートする
  • manifest.json の runtimeEventCount を確認する

コマンドが出力パスを拒否する場合：

  • bug-1234 のような相対名を使用する
  • /tmp/... または ~/... を渡さない
  • エクスポート先を .openclaw/trajectory-exports/ 内に保つ

エクスポートがサイズエラーで失敗する場合、セッションまたはサイドカーが上記の エクスポート安全上限を超えています。新しいセッションを開始するか、より小規模な 再現ケースをエクスポートしてください。

関連項目

Was this useful?
On this page

On this page