Langsung ke konten utama

​
Flag Diagnostik

Flag diagnostik memungkinkan Anda mengaktifkan log debug yang ditargetkan tanpa menyalakan logging verbose di semua tempat. Flag bersifat opt-in dan tidak berpengaruh kecuali suatu subsistem memeriksanya.

​
Cara kerjanya

  • Flag berupa string (tidak peka huruf besar/kecil).
  • Anda dapat mengaktifkan flag di konfigurasi atau melalui override env.
  • Wildcard didukung:
    • telegram.* cocok dengan telegram.http
    • * mengaktifkan semua flag

​
Aktifkan melalui konfigurasi

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
Beberapa flag: 
{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}
Mulai ulang gateway setelah mengubah flag.

​
Override env (sekali pakai)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
Nonaktifkan semua flag: 
OPENCLAW_DIAGNOSTICS=0

​
Ke mana log dikirim

Flag mengirim log ke file log diagnostik standar. Secara default: 
/tmp/openclaw/openclaw-YYYY-MM-DD.log
Jika Anda menetapkan logging.file, gunakan path itu sebagai gantinya. Log berformat JSONL (satu objek JSON per baris). Redaksi tetap berlaku berdasarkan logging.redactSensitive.

​
Ekstrak log

Pilih file log terbaru: 
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
Filter untuk diagnostik HTTP Telegram: 
rg "telegram http error" /tmp/openclaw/openclaw-*.log
Atau tail sambil mereproduksi: 
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
Untuk Gateway jarak jauh, Anda juga dapat menggunakan openclaw logs --follow (lihat /cli/logs).

​
Catatan

  • Jika logging.level disetel lebih tinggi daripada warn, log ini mungkin disembunyikan. Default info tidak masalah.
  • Flag aman dibiarkan tetap aktif; flag hanya memengaruhi volume log untuk subsistem tertentu.
  • Gunakan /logging untuk mengubah tujuan log, level, dan redaksi.