Langsung ke konten utama
OpenClaw dapat membuat zip diagnostik lokal untuk laporan bug. Zip ini menggabungkan status Gateway yang disanitasi, kesehatan, log, bentuk konfigurasi, dan peristiwa stabilitas terbaru tanpa payload. Perlakukan bundel diagnostik seperti rahasia sampai Anda meninjaunya. Bundel ini dirancang untuk menghilangkan atau menyunting payload dan kredensial, tetapi tetap merangkum log Gateway lokal dan status runtime tingkat host.

​
Mulai cepat

openclaw gateway diagnostics export
Perintah ini mencetak path zip yang ditulis. Untuk memilih path: 
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
Untuk otomatisasi: 
openclaw gateway diagnostics export --json

​
Perintah chat

Pemilik dapat menggunakan /diagnostics [note] di chat untuk meminta ekspor Gateway lokal. Gunakan ini ketika bug terjadi dalam percakapan nyata dan Anda menginginkan satu laporan yang dapat disalin-tempel untuk dukungan:
  1. Kirim /diagnostics di percakapan tempat Anda melihat masalah. Tambahkan catatan singkat jika membantu, misalnya /diagnostics bad tool choice.
  2. OpenClaw mengirim pembuka diagnostik dan meminta satu persetujuan exec eksplisit. Persetujuan ini menjalankan openclaw gateway diagnostics export --json. Jangan setujui diagnostik melalui aturan allow-all.
  3. Setelah disetujui, OpenClaw membalas dengan laporan yang dapat ditempel berisi path bundel lokal, ringkasan manifes, catatan privasi, dan id sesi yang relevan.
Di chat grup, pemilik tetap dapat menjalankan /diagnostics, tetapi OpenClaw tidak memposting detail diagnostik kembali ke chat bersama. OpenClaw mengirim pembuka, prompt persetujuan, hasil ekspor Gateway, dan perincian sesi/utas Codex kepada pemilik melalui rute persetujuan pribadi. Grup hanya menerima pemberitahuan singkat bahwa alur diagnostik dikirim secara pribadi. Jika OpenClaw tidak dapat menemukan rute pemilik pribadi, perintah gagal tertutup dan meminta pemilik menjalankannya dari DM. Ketika sesi OpenClaw aktif menggunakan harness OpenAI Codex native, persetujuan exec yang sama juga mencakup unggahan umpan balik OpenAI untuk utas runtime Codex yang diketahui OpenClaw. Unggahan itu terpisah dari zip Gateway lokal dan hanya muncul untuk sesi harness Codex. Sebelum persetujuan, prompt menjelaskan bahwa menyetujui diagnostik juga akan mengirim umpan balik Codex, tetapi tidak mencantumkan id sesi atau utas Codex. Setelah persetujuan, balasan chat mencantumkan kanal, id sesi OpenClaw, id utas Codex, dan perintah resume lokal untuk utas yang dikirim ke server OpenAI. Jika Anda menolak atau mengabaikan persetujuan, OpenClaw tidak menjalankan ekspor, tidak mengirim umpan balik Codex, dan tidak mencetak id Codex. Itu membuat loop debugging Codex umum menjadi singkat: lihat perilaku buruk di Telegram, Discord, atau kanal lain, jalankan /diagnostics, setujui sekali, bagikan laporan dengan dukungan, lalu jalankan perintah codex resume <thread-id> yang dicetak secara lokal jika Anda ingin memeriksa sendiri utas Codex native. Lihat harness Codex untuk alur kerja pemeriksaan tersebut.

​
Isi ekspor

Zip mencakup:
  • summary.md: ringkasan yang mudah dibaca manusia untuk dukungan.
  • diagnostics.json: ringkasan yang dapat dibaca mesin tentang konfigurasi, log, status, kesehatan, dan data stabilitas.
  • manifest.json: metadata ekspor dan daftar file.
  • Bentuk konfigurasi yang disanitasi dan detail konfigurasi non-rahasia.
  • Ringkasan log yang disanitasi dan baris log terbaru yang disunting.
  • Snapshot status dan kesehatan Gateway upaya terbaik.
  • stability/latest.json: bundel stabilitas tersimpan terbaru, jika tersedia.
Ekspor tetap berguna walaupun Gateway tidak sehat. Jika Gateway tidak dapat menjawab permintaan status atau kesehatan, log lokal, bentuk konfigurasi, dan bundel stabilitas terbaru tetap dikumpulkan jika tersedia.

​
Model privasi

Diagnostik dirancang agar dapat dibagikan. Ekspor mempertahankan data operasional yang membantu debugging, seperti:
  • nama subsistem, id Plugin, id penyedia, id kanal, dan mode yang dikonfigurasi
  • kode status, durasi, jumlah byte, status antrean, dan pembacaan memori
  • metadata log yang disanitasi dan pesan operasional yang disunting
  • bentuk konfigurasi dan pengaturan fitur non-rahasia
Ekspor menghilangkan atau menyunting:
  • teks chat, prompt, instruksi, bodi Webhook, dan keluaran alat
  • kredensial, kunci API, token, cookie, dan nilai rahasia
  • bodi permintaan atau respons mentah
  • id akun, id pesan, id sesi mentah, hostname, dan nama pengguna lokal
Ketika pesan log tampak seperti teks pengguna, chat, prompt, atau payload alat, ekspor hanya menyimpan bahwa pesan dihilangkan dan jumlah byte.

​
Perekam stabilitas

Gateway merekam stream stabilitas terbatas tanpa payload secara default ketika diagnostik diaktifkan. Ini untuk fakta operasional, bukan konten. Heartbeat diagnostik yang sama merekam sampel liveness ketika Gateway tetap berjalan tetapi loop peristiwa Node.js atau CPU terlihat jenuh. Peristiwa diagnostic.liveness.warning ini mencakup jeda loop peristiwa, utilisasi loop peristiwa, rasio core CPU, jumlah sesi aktif/menunggu/diantrekan, fase startup/runtime saat ini jika diketahui, rentang fase terbaru, dan label pekerjaan aktif/diantrekan yang dibatasi. Sampel idle tetap berada di telemetri pada level info. Sampel liveness menjadi peringatan Gateway hanya ketika pekerjaan sedang menunggu atau diantrekan, atau ketika pekerjaan aktif bertumpang tindih dengan jeda loop peristiwa yang berkelanjutan. Lonjakan max-delay sementara selama pekerjaan latar belakang yang sehat tetap berada di log debug. Peristiwa itu tidak memulai ulang Gateway dengan sendirinya. Fase startup juga memancarkan peristiwa diagnostic.phase.completed dengan timing wall-clock dan CPU. Diagnostik embedded-run yang macet menandai terminalProgressStale=true ketika progres bridge terakhir terlihat terminal, seperti item respons mentah atau peristiwa penyelesaian respons, tetapi Gateway masih menganggap embedded run aktif. Periksa perekam live: 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
Periksa bundel stabilitas tersimpan terbaru setelah fatal exit, timeout shutdown, atau kegagalan startup restart: 
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 ada peristiwa.

​
Opsi berguna

openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
  • --output <path>: tulis ke path zip tertentu.
  • --log-lines <count>: jumlah maksimum baris log yang disanitasi untuk disertakan.
  • --log-bytes <bytes>: byte log maksimum untuk diperiksa.
  • --url <url>: URL WebSocket Gateway untuk snapshot status dan kesehatan.
  • --token <token>: token Gateway untuk snapshot status dan kesehatan.
  • --password <password>: kata sandi Gateway untuk snapshot status dan kesehatan.
  • --timeout <ms>: timeout snapshot status dan kesehatan.
  • --no-stability-bundle: lewati pencarian bundel stabilitas tersimpan.
  • --json: cetak metadata ekspor yang dapat dibaca mesin.

​
Nonaktifkan diagnostik

Diagnostik diaktifkan secara default. Untuk menonaktifkan perekam stabilitas dan pengumpulan peristiwa diagnostik: 
{
  diagnostics: {
    enabled: false,
  },
}
Menonaktifkan diagnostik mengurangi detail laporan bug. Ini tidak memengaruhi logging Gateway normal. Snapshot tekanan memori kritis nonaktif secara default. Untuk mempertahankan peristiwa diagnostik dan juga menangkap snapshot stabilitas pra-OOM: 
{
  diagnostics: {
    memoryPressureSnapshot: true,
  },
}
Gunakan ini hanya pada host yang dapat menoleransi pemindaian sistem file tambahan dan penulisan snapshot selama tekanan memori kritis. Peristiwa tekanan memori normal tetap merekam RSS, heap, ambang batas, dan fakta pertumbuhan ketika snapshot nonaktif.

​
Terkait