Asosiy tarkibga o'tish

​
Loglash

Foydalanuvchi uchun umumiy ko‘rinish (CLI + Control UI + konfiguratsiya) uchun qarang: /logging. OpenClaw ikkita log “sirtiga” ega:
  • Konsol chiqishi (terminalda / Debug UI’da ko‘radiganingiz).
  • Fayl loglari (JSON qatorlari) gateway logger tomonidan yoziladi.

​
Faylga asoslangan logger

  • Standart aylanuvchi log fayli /tmp/openclaw/ ostida (kuniga bitta fayl): openclaw-YYYY-MM-DD.log
    • Sana gateway xostining lokal vaqt mintaqasidan foydalanadi.
  • Log fayl yo‘li va darajasi ~/.openclaw/openclaw.json orqali sozlanishi mumkin:
    • logging.file
    • logging.level
Fayl formati — har bir qatorda bitta JSON obyekt. Control UI’dagi Logs yorlig‘i ushbu faylni gateway orqali kuzatadi (logs.tail). CLI ham xuddi shuni qila oladi: 
openclaw logs --follow
Verbose va log darajalari
  • Fayl loglari faqat logging.level orqali boshqariladi.
  • --verbose faqat konsol batafsilligiga (va WS log uslubiga) ta’sir qiladi; u fayl log darajasini oshirmaydi.
  • Faqat verbose’da ko‘rinadigan tafsilotlarni fayl loglariga yozish uchun logging.level ni debug yoki trace ga o‘rnating.

​
Konsolni ushlash

CLI console.log/info/warn/error/debug/trace ni ushlab, ularni fayl loglariga yozadi, shu bilan birga stdout/stderr’ga chiqarishni davom ettiradi. Konsol batafsilligini mustaqil ravishda sozlashingiz mumkin:
  • logging.consoleLevel (standart info)
  • logging.consoleStyle (pretty | compact | json)

​
Asboblar xulosasini yashirish

Verbose asboblar xulosalari (masalan, 🛠️ Exec: ...) konsol oqimiga tushishidan oldin maxfiy tokenlarni yashirishi mumkin. Bu faqat asboblar uchun va fayl loglarini o‘zgartirmaydi.
  • logging.redactSensitive: off | tools (standart: tools)
  • logging.redactPatterns: regex satrlaridan iborat massiv (standartlarni bekor qiladi)
    • Xom regex satrlaridan foydalaning (avto gi), yoki maxsus flaglar kerak bo‘lsa /pattern/flags.
    • Mos kelishlar birinchi 6 + oxirgi 4 belgini saqlab yashiriladi (uzunligi >= 18), aks holda ***.
    • Standartlar keng tarqalgan kalit tayinlashlari, CLI flaglari, JSON maydonlari, bearer sarlavhalari, PEM bloklari va mashhur token prefikslarini qamrab oladi.

​
Gateway WebSocket loglari

Gateway WebSocket protokoli loglarini ikki rejimda chiqaradi:
  • Oddiy rejim (--verbose yo‘q): faqat “qiziqarli” RPC natijalari chiqariladi:
    • xatolar (ok=false)
    • sekin chaqiruvlar (standart chegarasi: >= 50ms)
    • tahlil (parse) xatolari
  • Verbose rejim (--verbose): barcha WS so‘rov/javob trafikini chiqaradi.

​
WS log uslubi

openclaw gateway har bir gateway uchun uslubni almashtirishni qo‘llab-quvvatlaydi:
  • --ws-log auto (standart): oddiy rejim optimallashtirilgan; verbose rejimda ixcham chiqish ishlatiladi
  • --ws-log compact: verbose’da ixcham chiqish (juftlangan so‘rov/javob)
  • --ws-log full: verbose’da har bir freym bo‘yicha to‘liq chiqish
  • --compact: --ws-log compact uchun alias
Misollar: 
# optimized (only errors/slow)
openclaw gateway

# show all WS traffic (paired)
openclaw gateway --verbose --ws-log compact

# show all WS traffic (full meta)
openclaw gateway --verbose --ws-log full

​
Console formatting (subsystem logging)

The console formatter is TTY-aware and prints consistent, prefixed lines. Subsystem loggers keep output grouped and scannable. Behavior:
  • Subsystem prefixes on every line (e.g. [gateway], [canvas], [tailscale])
  • Subsystem colors (stable per subsystem) plus level coloring
  • Color when output is a TTY or the environment looks like a rich terminal (TERM/COLORTERM/TERM_PROGRAM), respects NO_COLOR
  • Shortened subsystem prefixes: drops leading gateway/ + channels/, keeps last 2 segments (e.g. whatsapp/outbound)
  • Sub-loggers by subsystem (auto prefix + structured field { subsystem })
  • logRaw() for QR/UX output (no prefix, no formatting)
  • Console styles (e.g. pretty | compact | json)
  • Console log level separate from file log level (file keeps full detail when logging.level is set to debug/trace)
  • WhatsApp xabar matnlari debug darajasida log qilinadi (ularni ko‘rish uchun --verbose dan foydalaning)
This keeps existing file logs stable while making interactive output scannable.