Gateway

Gateway günlük kaydı

Günlükleme

Kullanıcıya yönelik genel bakış (CLI + Denetim Arayüzü + yapılandırma) için /logging sayfasına bakın.

OpenClaw iki günlük yüzeyine sahiptir:

Konsol çıktısı - terminalde / Hata Ayıklama Arayüzünde gördükleriniz.
Dosya günlükleri - Gateway günlükleyicisi tarafından yazılan JSON satırları.

Başlangıçta Gateway, çözümlenen varsayılan aracı modelini ve yeni oturumları etkileyen mod varsayılanlarını günlüğe kaydeder:

text

agent model: openai/gpt-5.6-sol (thinking=medium, fast=on)

thinking, varsayılan aracıdan, model parametrelerinden veya genel aracı varsayılanından gelir; ayarlanmadığında medium gösterilir. fast, varsayılan aracıdan veya modelin fastMode parametrelerinden gelir.

Dosya tabanlı günlükleyici

Varsayılan dönüşümlü günlük dosyası /tmp/openclaw/ altındadır (günde bir dosya): Gateway ana makinesinin yerel saat dilimine göre tarihlendirilen openclaw-YYYY-MM-DD.log. Bu dizin güvenli değilse veya yazılamıyorsa (yanlış sahip, herkesçe yazılabilir ya da sembolik bağlantıysa), OpenClaw bunun yerine kullanıcı kapsamlı bir os.tmpdir()/openclaw-<uid> yoluna geri döner; Windows'ta her zaman bu işletim sistemi geçici dizini geri dönüşünü kullanır.
Etkin günlük dosyaları logging.maxFileBytes değerinde (varsayılan: 100 MB) döndürülür; en fazla beş numaralı arşiv (.1 ile .5 arası) tutulur ve yeni bir etkin dosyaya yazılmaya devam edilir.
Günlük dosyası yolunu ve düzeyini ~/.openclaw/openclaw.json üzerinden yapılandırın: logging.file, logging.level.
Dosya biçimi, satır başına bir JSON nesnesidir.

Konuşma, gerçek zamanlı ses ve yönetilen oda kod yolları; operasyonel hata ayıklama ve OTLP günlük dışa aktarımı için tasarlanmış, sınırlandırılmış yaşam döngüsü kayıtlarında ortak dosya günlükleyicisini kullanır. Döküm metni, ses yükleri, tur kimlikleri, çağrı kimlikleri ve sağlayıcı öğesi kimlikleri hiçbir zaman günlük kaydına kopyalanmaz.

Denetim Arayüzünün Günlükler sekmesi, Gateway (logs.tail) aracılığıyla bu dosyanın sonunu takip eder. CLI da aynısını yapar:

bash

openclaw logs --follow

Ayrıntılı mod ve günlük düzeyleri

Dosya günlükleri yalnızca logging.level tarafından denetlenir.
--verbose yalnızca konsol ayrıntı düzeyini (ve WS günlük stilini) etkiler; dosya günlük düzeyini yükseltmez.
Yalnızca ayrıntılı modda bulunan ayrıntıları dosya günlüklerine kaydetmek için logging.level değerini debug veya trace olarak ayarlayın.
İzleme günlüğü, Plugin araç fabrikası hazırlığı gibi seçili yoğun kod yollarına yönelik tanılama zamanlama özetlerini de içerir. /tools/plugin#slow-plugin-tool-setup sayfasına bakın.

Konsol yakalama

CLI, console.log/info/warn/error/debug/trace çağrılarını yakalar, bunları dosya günlüklerine yazar ve yine de stdout/stderr'e yazdırır.

Konsol ayrıntı düzeyini bağımsız olarak ayarlayın:

logging.consoleLevel (varsayılan info)
logging.consoleStyle (pretty | compact | json; TTY üzerinde varsayılan olarak pretty, aksi durumda compact)

Gizleme

OpenClaw, günlük veya döküm çıktısı süreçten ayrılmadan önce hassas belirteçleri maskeler. Bu gizleme politikası konsol, dosya günlüğü, OTLP günlük kaydı ve oturum dökümü metni hedeflerinde geçerlidir; böylece eşleşen gizli değerler, JSONL satırları veya iletiler diske yazılmadan önce maskelenir.

logging.redactSensitive: off | tools (varsayılan: tools)
logging.redactPatterns: düzenli ifade dizgileri dizisi (varsayılanları geçersiz kılar)
- Ham düzenli ifade dizgileri (otomatik gi) veya özel bayraklar için /pattern/flags kullanın.
- Eşleşmeler, ilk 6 ve son 4 karakter korunarak maskelenir (18 veya daha fazla karakterli değerler); daha kısa değerler *** olur.
- Varsayılanlar; yaygın anahtar atamalarını, CLI bayraklarını, JSON alanlarını, bearer başlıklarını, PEM bloklarını, popüler tedarikçi belirteci öneklerini ve ödeme kimlik bilgisi alan adlarını (kart numarası, CVC/CVV, paylaşılan ödeme belirteci, ödeme kimlik bilgisi) kapsar.

Bazı güvenlik sınırları, logging.redactSensitive ayarından bağımsız olarak her zaman gizleme uygular: Denetim Arayüzü araç çağrısı olayları, sessions_history araç çıktısı, tanılama destek dışa aktarımları, sağlayıcı hata gözlemleri, exec onay komutu gösterimi ve Gateway WebSocket protokol günlükleri. Bu yüzeyler, ek kalıplar olarak logging.redactPatterns değerine yine uyar; ancak redactSensitive: "off" ham gizli değerler yayınlamalarını sağlamaz.

Gateway WebSocket günlükleri

Gateway, WebSocket protokol günlüklerini iki modda yazdırır:

Normal mod (--verbose olmadan): yalnızca "dikkate değer" RPC sonuçları yazdırılır; hatalar (ok=false), yavaş çağrılar (varsayılan eşik: >= 50ms) ve 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ını destekler:

--ws-log auto (varsayılan): normal mod optimize edilmiştir; ayrıntılı mod sıkıştırılmış çıktı kullanır.
--ws-log compact: ayrıntılı modda sıkıştırılmış çıktı (eşleştirilmiş istek/yanıt).
--ws-log full: ayrıntılı modda kare başına tam çıktı.
--compact: --ws-log compact için takma ad.

bash

# optimize edilmiş (yalnızca hatalar/yavaş çağrılar)openclaw gateway # tüm WS trafiğini göster (eşleştirilmiş)openclaw gateway --verbose --ws-log compact # tüm WS trafiğini göster (tam meta veriler)openclaw gateway --verbose --ws-log full

Konsol biçimlendirmesi (alt sistem günlükleme)

Konsol biçimlendiricisi TTY'ye duyarlıdır ve tutarlı, önekli satırlar yazdırır. Alt sistem günlükleyicileri çıktıyı gruplandırılmış ve kolayca taranabilir tutar:

Her satırda alt sistem önekleri (ör. [gateway], [canvas], [tailscale]).
Alt sistem renkleri (alt sistem başına kararlı, addan karma oluşturularak belirlenir) ve düzey renklendirmesi.
Çıktı bir TTY olduğunda veya ortam zengin bir terminal gibi göründüğünde (TERM/COLORTERM/TERM_PROGRAM) renk kullanımı; NO_COLOR ve FORCE_COLOR ayarlarına uyar.
Kısaltılmış alt sistem önekleri: baştaki gateway/, channels/ veya providers/ bölümünü kaldırır, ardından kalan bölümlerin en fazla son 2 tanesini tutar (ör. channels/turn/kernel, turn/kernel olarak görüntülenir). Bilinen kanal alt sistemleri (telegram, whatsapp, slack vb.) her zaman yalnızca kanal adına indirgenir.
Alt sisteme göre alt günlükleyiciler (otomatik önek + yapılandırılmış { subsystem } alanı).
QR/UX çıktısı için logRaw() (önek yok, biçimlendirme yok).
Konsol stilleri: pretty | compact | json.
Konsol günlük düzeyi, dosya günlük düzeyinden ayrıdır (logging.level, debug/trace olduğunda dosya tüm ayrıntıları korur).
WhatsApp ileti gövdeleri debug düzeyinde günlüğe kaydedilir (bunları görmek için --verbose kullanın).

Bu, etkileşimli çıktıyı kolayca taranabilir hâle getirirken dosya günlüklerini kararlı tutar.

İlgili konular

Was this useful?