Ekspor diagnostik

OpenClaw dapat membuat .zip diagnostik lokal untuk laporan bug: status, kesehatan, log, bentuk konfigurasi, dan peristiwa stabilitas terbaru tanpa payload dari Gateway yang telah disanitasi.

Perlakukan bundel diagnostik seperti rahasia hingga ditinjau. Payload dan kredensial disamarkan secara bawaan, tetapi bundel tersebut tetap merangkum log Gateway lokal dan status runtime tingkat host.

Mulai cepat

openclaw gateway diagnostics export

Mencetak jalur zip yang ditulis. Pilih jalur keluaran:

openclaw gateway diagnostics export --output openclaw-diagnostics.zip

Untuk otomatisasi:

openclaw gateway diagnostics export --json

Perintah chat

Pemilik dapat menjalankan /diagnostics [note] dalam percakapan apa pun untuk meminta ekspor Gateway lokal sebagai satu laporan dukungan yang dapat disalin dan ditempel:

1. Kirim /diagnostics, secara opsional dengan catatan singkat (/diagnostics bad tool choice).
2. OpenClaw mengirimkan pengantar dan meminta satu persetujuan eksekusi eksplisit, yang menjalankan openclaw gateway diagnostics export --json. Jangan menyetujui diagnostik melalui aturan izinkan-semua.
3. Setelah disetujui, OpenClaw membalas dengan jalur bundel lokal, ringkasan manifes, catatan privasi, dan id sesi yang relevan.

Dalam chat grup, pemilik tetap dapat menjalankan /diagnostics, tetapi OpenClaw mengirimkan hasil ekspor, permintaan persetujuan, dan rincian sesi/utas Codex kepada pemilik secara pribadi. Grup hanya melihat pemberitahuan singkat bahwa diagnostik dikirim secara pribadi. Jika tidak ada rute pribadi ke pemilik, perintah gagal secara tertutup dan meminta pemilik menjalankannya dari DM.

Ketika sesi aktif menggunakan harness OpenAI Codex native, persetujuan eksekusi yang sama juga mencakup pengunggahan umpan balik OpenAI untuk utas Codex yang diketahui OpenClaw. Pengunggahan tersebut terpisah dari zip Gateway lokal dan hanya terjadi untuk sesi harness Codex. Permintaan persetujuan menyatakan bahwa persetujuan juga mengirimkan umpan balik Codex, tanpa mencantumkan id sesi atau utas Codex. Setelah disetujui, balasan mencantumkan channel, id sesi OpenClaw, id utas Codex, dan perintah pelanjutan lokal untuk utas yang dikirim ke OpenAI. Menolak atau mengabaikan persetujuan akan melewati ekspor, pengunggahan umpan balik Codex, dan daftar id Codex.

Hal tersebut mempersingkat siklus debugging Codex: perhatikan perilaku buruk pada suatu channel, jalankan /diagnostics, setujui sekali, bagikan laporan, lalu jalankan perintah codex resume <thread-id> yang dicetak secara lokal jika Anda ingin memeriksa sendiri utas tersebut. Lihat harness Codex.

Isi ekspor

• summary.md: ikhtisar yang mudah dibaca untuk dukungan.
• diagnostics.json: ringkasan konfigurasi, log, status, kesehatan, dan data stabilitas yang dapat dibaca mesin.
• manifest.json: metadata ekspor dan daftar berkas.
• Bentuk konfigurasi yang telah disanitasi dan detail konfigurasi nonrahasia.
• Ringkasan log yang telah disanitasi dan baris log terbaru yang telah disamarkan.
• Snapshot status dan kesehatan Gateway dengan upaya terbaik.
• stability/latest.json: bundel stabilitas tersimpan terbaru, jika tersedia.

Ekspor tetap berguna ketika Gateway tidak sehat: jika permintaan status/kesehatan gagal, log lokal, bentuk konfigurasi, dan bundel stabilitas terbaru tetap dikumpulkan jika tersedia.

Model privasi

Dipertahankan: nama subsistem, id plugin, id penyedia, id channel, mode yang dikonfigurasi, kode status, durasi, jumlah byte, status antrean, pembacaan memori, metadata log yang telah disanitasi, pesan operasional yang telah disamarkan, bentuk konfigurasi, dan pengaturan fitur nonrahasia.

Dihilangkan atau disamarkan: teks chat, prompt, instruksi, isi webhook, keluaran alat, kredensial, kunci API, token, cookie, nilai rahasia, isi mentah permintaan/respons, id akun, id pesan, id sesi mentah, nama host, dan nama pengguna lokal.

Ketika pesan log tampak seperti teks payload pengguna, chat, prompt, atau alat, ekspor hanya menyimpan informasi bahwa suatu pesan dihilangkan beserta jumlah byte-nya.

Perekam stabilitas

Gateway secara bawaan merekam aliran stabilitas terbatas tanpa payload ketika diagnostik diaktifkan. Aliran ini merekam fakta operasional, bukan konten.

Heartbeat yang sama juga mengambil sampel keaktifan ketika event loop atau CPU tampak jenuh, dengan memancarkan peristiwa diagnostic.liveness.warning yang berisi penundaan event loop, utilisasi event loop, rasio inti CPU, jumlah sesi aktif/menunggu/diantrekan, fase startup/runtime saat ini (jika diketahui), rentang fase terbaru, dan label pekerjaan terbatas. Peristiwa ini menjadi baris log tingkat warn Gateway hanya ketika pekerjaan sedang menunggu atau diantrekan, atau ketika pekerjaan aktif tumpang tindih dengan penundaan event loop yang berkelanjutan; jika tidak, peristiwa dicatat pada debug. Sampel keaktifan saat menganggur tetap dicatat sebagai peristiwa diagnostik, tetapi tidak pernah meningkat menjadi peringatan dengan sendirinya.

Fase startup memancarkan peristiwa diagnostic.phase.completed dengan pengaturan waktu jam dinding dan CPU. Diagnostik eksekusi tertanam yang macet menandai terminalProgressStale=true ketika progres bridge terakhir tampak terminal (misalnya item respons mentah atau peristiwa penyelesaian respons), tetapi Gateway masih menganggap eksekusi tertanam tersebut aktif.

Periksa perekam langsung:

openclaw gateway stabilityopenclaw gateway stability --type payload.largeopenclaw gateway stability --json

Periksa bundel tersimpan terbaru setelah keluar fatal, batas waktu penghentian, atau kegagalan startup saat memulai ulang:

openclaw gateway stability --bundle latest

Buat zip diagnostik dari bundel tersimpan terbaru:

openclaw gateway stability --bundle latest --export

Bundel tersimpan berada di bawah ~/.openclaw/logs/stability/ ketika terdapat peristiwa.

Opsi yang berguna

openclaw gateway diagnostics export \  --output openclaw-diagnostics.zip \  --log-lines 5000 \  --log-bytes 1000000

Menonaktifkan diagnostik

Diagnostik diaktifkan secara bawaan. Untuk menonaktifkan perekam stabilitas dan pengumpulan peristiwa diagnostik:

{  diagnostics: {    enabled: false,  },}

Menonaktifkan diagnostik mengurangi detail laporan bug; hal ini tidak memengaruhi pencatatan log Gateway normal.

Peristiwa tekanan memori mencatat fakta RSS, heap, ambang batas, dan pertumbuhan (rss_threshold, heap_threshold, rss_growth) tanpa melakukan pemindaian sistem berkas atau menulis snapshot pra-OOM.

Terkait

• Pemeriksaan kesehatan
• CLI Gateway
• Protokol Gateway
• Pencatatan log
• Ekspor OpenTelemetry - alur terpisah untuk mengalirkan diagnostik ke kolektor