Gateway

Ekspor diagnostik

OpenClaw dapat membuat zip diagnostik lokal untuk laporan bug. Zip ini menggabungkan status Gateway, kesehatan, log, bentuk konfigurasi, dan peristiwa stabilitas terbaru tanpa payload yang sudah disanitasi.

Perlakukan bundel diagnostik seperti rahasia sampai Anda meninjaunya. Bundel ini dirancang untuk menghilangkan atau menyamarkan 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 automasi:

openclaw gateway diagnostics export --json

Perintah chat

Pemilik dapat menggunakan /diagnostics [note] di chat untuk meminta ekspor Gateway lokal. Gunakan ini saat bug terjadi dalam percakapan nyata dan Anda menginginkan satu laporan yang dapat disalin-tempel untuk dukungan:

Kirim /diagnostics dalam percakapan tempat Anda melihat masalahnya. Tambahkan catatan singkat jika membantu, misalnya /diagnostics bad tool choice.
OpenClaw mengirim pembuka diagnostik dan meminta satu persetujuan exec eksplisit. Persetujuan tersebut menjalankan openclaw gateway diagnostics export --json. Jangan menyetujui diagnostik melalui aturan izinkan-semua.
Setelah disetujui, OpenClaw membalas dengan laporan yang dapat ditempel berisi path bundel lokal, ringkasan manifes, catatan privasi, dan id sesi yang relevan.

Dalam chat grup, pemilik tetap dapat menjalankan /diagnostics, tetapi OpenClaw tidak mengirim detail diagnostik kembali ke chat bersama. OpenClaw mengirim pembuka, prompt persetujuan, hasil ekspor Gateway, dan perincian sesi/thread Codex kepada pemilik melalui rute persetujuan privat. Grup hanya menerima pemberitahuan singkat bahwa alur diagnostik dikirim secara privat. Jika OpenClaw tidak dapat menemukan rute pemilik privat, perintah gagal secara tertutup dan meminta pemilik menjalankannya dari DM.

Saat sesi OpenClaw aktif menggunakan harness OpenAI Codex native, persetujuan exec yang sama juga mencakup unggahan umpan balik OpenAI untuk thread 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 thread Codex. Setelah disetujui, balasan chat mencantumkan channel, id sesi OpenClaw, id thread Codex, dan perintah resume lokal untuk thread 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 channel 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 thread Codex native. Lihat harness Codex untuk alur kerja pemeriksaan tersebut.

Isi ekspor

Zip mencakup:

summary.md: ikhtisar yang dapat 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 nonrahasia.
Ringkasan log yang disanitasi dan baris log terbaru yang disamarkan.
Snapshot status dan kesehatan Gateway upaya-terbaik.
stability/latest.json: bundel stabilitas tersimpan terbaru, jika tersedia.

Ekspor tetap berguna meski 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 channel, dan mode yang dikonfigurasi
kode status, durasi, jumlah byte, status antrean, dan pembacaan memori
metadata log yang disanitasi dan pesan operasional yang disamarkan
bentuk konfigurasi dan pengaturan fitur nonrahasia

Ekspor menghilangkan atau menyamarkan:

teks chat, prompt, instruksi, isi webhook, dan keluaran tool
kredensial, kunci API, token, cookie, dan nilai rahasia
isi permintaan atau respons mentah
id akun, id pesan, id sesi mentah, hostname, dan nama pengguna lokal

Saat pesan log tampak seperti teks pengguna, chat, prompt, atau payload tool, ekspor hanya mempertahankan bahwa sebuah pesan dihilangkan beserta jumlah byte-nya.

Perekam stabilitas

Gateway merekam stream stabilitas terbatas tanpa payload secara default saat diagnostik diaktifkan. Ini untuk fakta operasional, bukan konten.

Heartbeat diagnostik yang sama merekam sampel liveness saat Gateway tetap berjalan tetapi event loop Node.js atau CPU terlihat jenuh. Peristiwa diagnostic.liveness.warning ini mencakup jeda 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 kerja aktif/diantrekan yang dibatasi. Sampel idle tetap berada di telemetri pada level info. Sampel liveness menjadi peringatan Gateway hanya saat ada pekerjaan yang menunggu atau diantrekan, atau saat pekerjaan aktif bertumpang tindih dengan jeda event-loop berkelanjutan. Lonjakan max-delay sementara selama pekerjaan latar belakang yang sehat tetap berada di log debug. Lonjakan itu tidak me-restart 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 saat progres bridge terakhir tampak 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 keluar fatal, 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/ saat 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 tersanitasi yang 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>: 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.

Terkait

Pemeriksaan kesehatan
CLI Gateway
Protokol Gateway
Logging
Ekspor OpenTelemetry — alur terpisah untuk streaming diagnostik ke kolektor

# Mulai cepat

# Perintah chat

# Isi ekspor

# Model privasi

# Perekam stabilitas

# Opsi berguna

# Nonaktifkan diagnostik

# Terkait