Skip to main content
Perekaman trajektori adalah perekam penerbangan per sesi milik OpenClaw. Fitur ini merekam linimasa terstruktur untuk setiap proses agen, lalu /export-trajectory mengemas sesi saat ini menjadi bundel dukungan yang telah disunting, yang mencakup:
  • Prompt, prompt sistem, dan alat yang dikirim ke model
  • Pesan transkrip dan panggilan alat yang menghasilkan jawaban
  • Apakah proses mengalami batas waktu, dibatalkan, mengalami Compaction, atau menemui kesalahan penyedia
  • Model, plugin, Skills, dan pengaturan runtime yang aktif
  • Metadata penggunaan dan cache prompt yang dikembalikan penyedia
Untuk laporan dukungan Gateway yang luas, mulailah dengan /diagnostics; perintah ini mengumpulkan bundel Gateway yang telah disanitasi dan, untuk sesi harness OpenAI Codex, dapat mengirim umpan balik Codex ke OpenAI setelah disetujui. Gunakan /export-trajectory saat memerlukan linimasa terperinci per sesi untuk prompt, alat, dan transkrip.

​
Mulai cepat

Kirim dalam sesi aktif (alias /trajectory):
OpenClaw menulis bundel di bawah ruang kerja:
Berikan nama direktori keluaran relatif untuk menggantinya:
Nama tersebut diuraikan di dalam .openclaw/trajectory-exports/. Jalur absolut dan jalur ~ ditolak. Bundel trajektori dapat berisi prompt, pesan model, skema alat, hasil alat, peristiwa runtime, dan jalur lokal, sehingga perintah chat selalu dijalankan melalui persetujuan eksekusi. Setujui ekspor satu kali saat Anda memang bermaksud membuat bundel tersebut; jangan gunakan izinkan-semua. Dalam chat grup, OpenClaw mengirimkan prompt persetujuan dan hasil ekspor secara privat kepada pemilik, alih-alih memposting detail trajektori kembali ke ruang bersama. Untuk pemeriksaan lokal atau alur kerja dukungan, jalankan perintah CLI yang mendasarinya secara langsung:
Flag lainnya: --output <path> (nama direktori di dalam .openclaw/trajectory-exports), --store <path> (penggantian penyimpanan sesi), --agent <id> (ID agen untuk resolusi penyimpanan), --json (keluaran terstruktur).

​
Akses

Ekspor trajektori adalah perintah pemilik. Pengirim harus lulus pemeriksaan otorisasi perintah normal serta pemeriksaan pemilik untuk kanal tersebut.

​
Yang direkam

Perekaman trajektori aktif secara default untuk proses 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, serta apakah rantai berlanjut, berhasil, atau telah habis
  • model.completed
  • trace.artifacts
  • session.ended
Peristiwa transkrip direkonstruksi dari cabang sesi aktif: pesan pengguna, pesan asisten, panggilan alat, hasil alat, Compaction, perubahan model, label, dan entri sesi khusus. Peristiwa ditulis sebagai JSON Lines dengan penanda skema ini:

​
File bundel

manifest.json mencantumkan file yang ada dalam bundel tertentu; beberapa file dihilangkan jika sesi tidak merekam data runtime yang sesuai.

​
Penyimpanan rekaman

Peristiwa trajektori runtime disimpan bersama sesi dalam basis data SQLite per agen. Mengekspor trajektori menghasilkan bundel dukungan JSONL yang telah disunting; rekaman runtime aktif bukan file pendamping JSONL di samping sesi. File .trajectory.jsonl dan .trajectory-path.json lama mungkin masih muncul dari rilis terdahulu atau ekspor file lama yang eksplisit. Pemeliharaan sesi memperlakukan file tersebut sebagai target pembersihan; perekaman aktif menulis baris basis data.

​
Menonaktifkan perekaman

Ini menonaktifkan perekaman trajektori runtime sebelum memulai OpenClaw. /export-trajectory masih dapat mengekspor cabang transkrip, tetapi data khusus runtime seperti konteks terkompilasi, artefak penyedia, dan metadata prompt mungkin tidak tersedia.

​
Menyesuaikan batas waktu flush

OpenClaw melakukan flush baris trajektori runtime selama pembersihan agen. Batas waktu pembersihan default adalah 10,000 ms. Pada disk lambat atau penyimpanan besar, tetapkan OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS sebelum memulai OpenClaw:
Ini mengontrol kapan OpenClaw mencatat batas waktu openclaw-trajectory-flush dan melanjutkan; pengaturan ini tidak mengubah batas ukuran trajektori. Untuk menyesuaikan semua langkah pembersihan agen yang tidak memberikan batas waktu eksplisit, tetapkan OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.

​
Privasi dan batas

Bundel trajektori ditujukan untuk dukungan dan debugging, bukan untuk diposting secara publik. OpenClaw menyunting nilai sensitif sebelum menulis file ekspor:
  • kredensial dan bidang payload yang diketahui menyerupai rahasia
  • data gambar
  • jalur status lokal
  • jalur ruang kerja, diganti dengan $WORKSPACE_DIR
  • jalur direktori home, jika terdeteksi
Pengekspor juga membatasi ukuran masukan:
  • perekaman runtime: rekaman aktif adalah jendela bergulir yang dibatasi hingga 10 MiB, dengan menghapus peristiwa terlama untuk memberi ruang bagi peristiwa baru; ekspor menerima file pendamping runtime lama yang sudah ada hingga 50 MiB
  • file sesi: 50 MiB
  • peristiwa runtime per ekspor: 200,000
  • total peristiwa yang diekspor: 250,000
  • baris peristiwa runtime individual dipotong jika melebihi 256 KiB
Tinjau bundel sebelum membagikannya ke luar tim Anda. Penyuntingan dilakukan dengan upaya terbaik dan tidak dapat mengetahui setiap rahasia khusus aplikasi.

​
Pemecahan masalah

Jika ekspor tidak memiliki peristiwa runtime:
  • pastikan OpenClaw dimulai tanpa OPENCLAW_TRAJECTORY=0
  • jalankan pesan lain dalam sesi, lalu ekspor kembali
  • periksa manifest.json untuk runtimeEventCount
Jika perintah menolak jalur keluaran:
  • gunakan nama relatif seperti bug-1234
  • jangan berikan /tmp/... atau ~/...
  • pertahankan ekspor di dalam .openclaw/trajectory-exports/
Jika ekspor gagal karena kesalahan ukuran, sesi atau file pendamping melampaui batas keamanan ekspor di atas. Mulai sesi baru atau ekspor reproduksi yang lebih kecil.

​
Terkait