Bundel trajektori

Trajectory capture adalah perekam perjalanan per sesi OpenClaw. Fitur ini merekam timeline terstruktur untuk setiap eksekusi agen, lalu /export-trajectory mengemas sesi saat ini menjadi bundle dukungan yang telah disamarkan.

Gunakan saat Anda perlu menjawab pertanyaan seperti:

• Prompt, system prompt, dan alat apa yang dikirim ke model?
• Pesan transkrip dan panggilan alat mana yang menghasilkan jawaban ini?
• Apakah eksekusi mengalami timeout, dibatalkan, mengalami Compaction, atau terkena kesalahan penyedia?
• Model, Plugin, Skills, dan pengaturan runtime mana yang aktif?
• Metadata penggunaan dan prompt-cache apa yang dikembalikan penyedia?

Jika Anda membuat laporan dukungan luas untuk masalah Gateway live, mulai dengan /diagnostics. Diagnostics mengumpulkan bundle Gateway yang telah disanitasi dan, untuk sesi harness OpenAI Codex, juga dapat mengirim umpan balik Codex ke server OpenAI setelah disetujui. Gunakan /export-trajectory saat Anda secara khusus memerlukan timeline prompt, alat, dan transkrip per sesi yang terperinci.

# Mulai cepat

Kirim ini di sesi aktif:

/export-trajectory

Alias:

/trajectory

OpenClaw menulis bundle di bawah workspace:

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

Anda dapat memilih nama direktori output relatif:

/export-trajectory bug-1234

Path kustom diselesaikan di dalam .openclaw/trajectory-exports/. Path absolut dan path ~ ditolak.

Bundle trajectory dapat berisi prompt, pesan model, skema alat, hasil alat, peristiwa runtime, dan path lokal. Karena itu, perintah slash chat selalu berjalan melalui persetujuan exec. Setujui ekspor sekali saat Anda memang ingin membuat bundle; jangan gunakan allow-all. Di chat grup, OpenClaw mengirim prompt persetujuan dan hasil ekspor kepada pemilik secara privat, bukan memposting detail trajectory kembali ke ruang bersama.

Untuk inspeksi lokal atau alur kerja dukungan, Anda juga dapat menjalankan path perintah yang disetujui secara langsung:

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

# Akses

Ekspor trajectory adalah perintah pemilik. Pengirim harus lolos pemeriksaan otorisasi perintah normal dan pemeriksaan pemilik untuk channel tersebut.

# Apa yang direkam

Trajectory capture aktif secara default untuk eksekusi agen OpenClaw.

Peristiwa runtime mencakup:

• session.started
• trace.metadata
• context.compiled
• prompt.submitted
• model.fallback_step, termasuk model sumber, model berikutnya, alasan/detail kegagalan, posisi rantai, dan apakah fallback maju, berhasil, atau menghabiskan rantai
• model.completed
• trace.artifacts
• session.ended

Peristiwa transkrip juga direkonstruksi dari cabang sesi aktif:

• pesan pengguna
• pesan asisten
• panggilan alat
• hasil alat
• compaction
• perubahan model
• label dan entri sesi kustom

Peristiwa ditulis sebagai JSON Lines dengan marker skema ini:

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

# File bundle

Bundle yang diekspor dapat berisi:

File	Isi
manifest.json	Skema bundle, file sumber, jumlah peristiwa, dan daftar file yang dihasilkan
events.jsonl	Timeline runtime dan transkrip yang berurutan
session-branch.json	Cabang transkrip aktif dan header sesi yang telah disamarkan
metadata.json	Versi OpenClaw, OS/runtime, model, snapshot konfigurasi, Plugin, Skills, dan metadata prompt
artifacts.json	Status akhir, kesalahan, penggunaan, prompt cache, jumlah compaction, teks asisten, dan metadata alat
prompts.json	Prompt yang dikirim dan detail pembuatan prompt yang dipilih
system-prompt.txt	System prompt terkompilasi terbaru, saat tertangkap
tools.json	Definisi alat yang dikirim ke model, saat tertangkap

manifest.json mencantumkan file yang ada dalam bundle tersebut. Beberapa file dihilangkan ketika sesi tidak menangkap data runtime yang sesuai.

# Lokasi capture

Secara default, peristiwa trajectory runtime ditulis di samping file sesi:

<session>.trajectory.jsonl

OpenClaw juga menulis file pointer best-effort di samping sesi:

<session>.trajectory-path.json

Atur OPENCLAW_TRAJECTORY_DIR untuk menyimpan sidecar trajectory runtime di direktori khusus:

export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories

Saat variabel ini diatur, OpenClaw menulis satu file JSONL per id sesi di direktori tersebut.

Pemeliharaan sesi menghapus sidecar trajectory saat entri sesi pemiliknya dipangkas, dibatasi, atau dikeluarkan oleh anggaran disk sesi. File runtime di luar direktori sesi hanya dihapus saat target pointer masih membuktikan bahwa file itu milik sesi tersebut.

# Nonaktifkan capture

Atur OPENCLAW_TRAJECTORY=0 sebelum memulai OpenClaw:

export OPENCLAW_TRAJECTORY=0

Ini menonaktifkan capture trajectory runtime. /export-trajectory masih dapat mengekspor cabang transkrip, tetapi file khusus runtime seperti konteks terkompilasi, artefak penyedia, dan metadata prompt mungkin tidak ada.

# Privasi dan batasan

Bundle trajectory dirancang untuk dukungan dan debugging, bukan untuk diposting publik. OpenClaw menyamarkan nilai sensitif sebelum menulis file ekspor:

• kredensial dan field payload yang diketahui menyerupai rahasia
• data gambar
• path status lokal
• path workspace, diganti dengan $WORKSPACE_DIR
• path direktori home, jika terdeteksi

Exporter juga membatasi ukuran input:

• file sidecar runtime: capture live berhenti pada 10 MiB dan merekam peristiwa pemotongan saat masih ada ruang; ekspor menerima sidecar runtime yang sudah ada hingga 50 MiB
• file sesi: 50 MiB
• peristiwa runtime: 200.000
• total peristiwa yang diekspor: 250.000
• baris peristiwa runtime individual dipotong di atas 256 KiB

Tinjau bundle sebelum membagikannya di luar tim Anda. Penyamaran bersifat best-effort dan tidak dapat mengetahui setiap rahasia khusus aplikasi.

# Pemecahan masalah

Jika ekspor tidak memiliki peristiwa runtime:

• pastikan OpenClaw dimulai tanpa OPENCLAW_TRAJECTORY=0
• periksa apakah OPENCLAW_TRAJECTORY_DIR mengarah ke direktori yang dapat ditulis
• jalankan pesan lain di sesi, lalu ekspor lagi
• inspeksi manifest.json untuk runtimeEventCount

Jika perintah menolak path output:

• gunakan nama relatif seperti bug-1234
• jangan berikan /tmp/... atau ~/...
• pertahankan ekspor di dalam .openclaw/trajectory-exports/

Jika ekspor gagal dengan kesalahan ukuran, sesi atau sidecar telah melebihi batas keamanan ekspor. Mulai sesi baru atau ekspor reproduksi yang lebih kecil.

# Terkait

• Diff
• Manajemen sesi
• Alat exec