Ana içeriğe atla

​
Logging

Kullanıcıya dönük bir genel bakış için (CLI + Control UI + yapılandırma), bkz. /logging. OpenClaw’ın iki günlük “yüzeyi” vardır:
  • Konsol çıktısı (terminalde / Debug UI’da gördükleriniz).
  • Dosya günlükleri (JSON satırları), gateway günlükleyicisi tarafından yazılır.

​
Dosya tabanlı günlükleyici

  • Varsayılan dönen günlük dosyası /tmp/openclaw/ altında yer alır (günde bir dosya): openclaw-YYYY-MM-DD.log
    • Tarih, gateway ana makinesinin yerel saat dilimini kullanır.
  • Günlük dosyası yolu ve seviyesi ~/.openclaw/openclaw.json üzerinden yapılandırılabilir:
    • logging.file
    • logging.level
Dosya biçimi, satır başına bir JSON nesnesidir. Control UI Logs sekmesi bu dosyayı gateway üzerinden takip eder (logs.tail). CLI de aynısını yapabilir: 
openclaw logs --follow
Ayrıntılı vs. günlük seviyeleri
  • Dosya günlükleri yalnızca logging.level tarafından kontrol edilir.
  • --verbose yalnızca konsol ayrıntı düzeyini (ve WS günlük stilini) etkiler; dosya günlük seviyesini artırmaz.
  • Ayrıntı‑özel bilgileri dosya günlüklerinde yakalamak için logging.level’ı debug veya trace olarak ayarlayın.

​
Konsol yakalama

CLI, console.log/info/warn/error/debug/trace’leri yakalar ve dosya günlüklerine yazar, aynı zamanda stdout/stderr’e yazdırmaya devam eder. Konsol ayrıntı düzeyini bağımsız olarak ayarlayabilirsiniz:
  • logging.consoleLevel (varsayılan info)
  • logging.consoleStyle (pretty | compact | json)

​
Tool summary redaction

Ayrıntılı araç özetleri (örn. 🛠️ Exec: ...), konsol akışına ulaşmadan önce hassas belirteçleri maskeleyebilir. Bu yalnızca araçlar içindir ve dosya günlüklerini değiştirmez.
  • logging.redactSensitive: off | tools (varsayılan: tools)
  • logging.redactPatterns: regex dizelerinden oluşan dizi (varsayılanları geçersiz kılar)
    • Ham regex dizeleri kullanın (otomatik gi), ya da özel bayraklara ihtiyacınız varsa /pattern/flags.
    • Eşleşmeler, ilk 6 + son 4 karakter korunarak maskelenir (uzunluk >= 18); aksi halde ***.
    • Varsayılanlar; yaygın anahtar atamaları, CLI bayrakları, JSON alanları, bearer başlıkları, PEM blokları ve popüler belirteç öneklerini kapsar.

​
Gateway WebSocket günlükleri

Gateway, WebSocket protokol günlüklerini iki modda yazdırır:
  • Normal mod ( --verbose yok): yalnızca “ilginç” RPC sonuçları yazdırılır:
    • hatalar (ok=false)
    • yavaş çağrılar (varsayılan eşik: >= 50ms)
    • ayrıştırma hataları
  • Ayrıntılı mod (--verbose): tüm WS istek/yanıt trafiğini yazdırır.

​
WS günlük stili

openclaw gateway, gateway başına bir stil anahtarı destekler:
  • --ws-log auto (varsayılan): normal mod optimize edilmiştir; ayrıntılı modda kompakt çıktı kullanır
  • --ws-log compact: ayrıntılı modda kompakt çıktı (eşleştirilmiş istek/yanıt)
  • --ws-log full: ayrıntılı modda çerçeve başına tam çıktı
  • --compact: --ws-log compact için takma ad
Örnekler: 
# 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

​
Konsol biçimlendirme (alt sistem günlükleme)

Konsol biçimlendirici TTY farkındadır ve tutarlı, önekli satırlar yazdırır. Alt sistem günlükleyicileri çıktıyı gruplu ve taranabilir tutar. Davranış:
  • Her satırda alt sistem önekleri (örn. [gateway], [canvas], [tailscale])
  • Alt sistem renkleri (alt sistem başına sabit) ve seviye renklendirmesi
  • Çıktı TTY olduğunda veya ortam zengin bir terminal gibi göründüğünde renklendirme (TERM/COLORTERM/TERM_PROGRAM), NO_COLOR’e saygı duyar
  • Kısaltılmış alt sistem önekleri: baştaki gateway/ + channels/ kaldırılır, son 2 segment korunur (örn. whatsapp/outbound)
  • Alt sisteme göre alt‑günlükleyiciler (otomatik önek + yapılandırılmış alan { subsystem })
  • QR/UX çıktısı için logRaw() (önek yok, biçimlendirme yok)
  • Konsol stilleri (örn. pretty | compact | json)
  • Konsol günlük seviyesi, dosya günlük seviyesinden ayrıdır (dosya, logging.level debug/trace olarak ayarlandığında tam ayrıntıyı korur)
  • WhatsApp mesaj gövdeleri debug seviyesinde günlüğe alınır (görmek için --verbose kullanın)
Bu, mevcut dosya günlüklerini sabit tutarken etkileşimli çıktıyı taranabilir hale getirir.