---
read_when:
    - エージェントが特定の方法で応答した、失敗した、またはツールを呼び出した理由のデバッグ
    - OpenClaw セッションのサポートバンドルをエクスポートする
    - プロンプトコンテキスト、ツール呼び出し、ランタイムエラー、または使用状況メタデータの調査
    - 軌跡キャプチャの無効化
summary: OpenClaw エージェントセッションのデバッグ用に秘匿化済みの軌跡バンドルをエクスポートする
title: 軌跡バンドル
x-i18n:
    generated_at: "2026-07-12T14:58:17Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 15
    provider: openai
    source_hash: 7fc494732b6239ad4ea58dca3920a47cb7433c680e7566855dd265c986b55e74
    source_path: tools/trajectory.md
    workflow: 16
---

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

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

広範な Gateway サポートレポートが必要な場合は、代わりに
[`/diagnostics`](/ja-JP/gateway/diagnostics#chat-command) から始めてください。これは、
サニタイズ済みの 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/` 内に保つ

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

## 関連項目

- [差分](/ja-JP/tools/diffs)
- [セッション管理](/ja-JP/concepts/session)
- [Exec ツール](/ja-JP/tools/exec)