CLI commands

Günlükler

`openclaw logs`

Gateway dosya günlüklerini RPC üzerinden izleyin (uzak modda çalışır).

İlgili:

Günlük kaydı genel bakışı: Günlük kaydı
Gateway CLI: gateway

Seçenekler

--limit <n>: döndürülecek en fazla günlük satırı sayısı (varsayılan 200)
--max-bytes <n>: günlük dosyasından okunacak en fazla bayt (varsayılan 250000)
--follow: günlük akışını takip et
--interval <ms>: takip ederken yoklama aralığı (varsayılan 1000)
--json: satırla ayrılmış JSON olayları üret
--plain: stillendirilmiş biçimlendirme olmadan düz metin çıktısı
--no-color: ANSI renklerini devre dışı bırak
--local-time: zaman damgalarını yerel saat diliminizde işle (varsayılan)
--utc: zaman damgalarını UTC olarak işle

Paylaşılan Gateway RPC seçenekleri

openclaw logs standart Gateway istemci bayraklarını da kabul eder:

--url <url>: Gateway WebSocket URL'si
--token <token>: Gateway token'ı
--timeout <ms>: ms cinsinden zaman aşımı (varsayılan 30000)
--expect-final: Gateway çağrısı agent destekliyse nihai yanıtı bekle

--url ilettiğinizde CLI, yapılandırma veya ortam kimlik bilgilerini otomatik olarak uygulamaz. Hedef Gateway kimlik doğrulaması gerektiriyorsa --token değerini açıkça ekleyin.

Örnekler

bash

openclaw logsopenclaw logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --limit 500openclaw logs --local-timeopenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Notlar

Zaman damgaları varsayılan olarak yerel saat diliminizde işlenir. UTC çıktısı için --utc kullanın.
Örtük local loopback Gateway eşleştirme isterse, bağlantı sırasında kapanırsa veya logs.tail yanıt vermeden önce zaman aşımına uğrarsa, openclaw logs otomatik olarak yapılandırılmış Gateway dosya günlüğüne geri döner. Açık --url hedefleri bu geri dönüşü kullanmaz.
openclaw logs --follow, örtük yerel Gateway RPC hatalarından sonra yapılandırılmış dosya geri dönüşlerini takip etmez. Linux'ta, kullanılabilir olduğunda PID'ye göre etkin kullanıcı-systemd Gateway günlüğünü kullanır ve seçilen günlük kaynağını yazdırır; aksi halde olası eski bir yan yana dosyayı izlemek yerine canlı Gateway'i yeniden denemeyi sürdürür.
--follow kullanılırken geçici gateway bağlantı kesilmeleri (WebSocket kapanması, zaman aşımı, bağlantı kopması) üstel geri çekilme ile otomatik yeniden bağlantıyı tetikler (en fazla 8 yeniden deneme, denemeler arası en çok 30 sn). Her yeniden denemede stderr'e bir uyarı yazdırılır ve bir yoklama başarılı olduğunda [logs] gateway reconnected bildirimi yazdırılır. --json modunda hem yeniden deneme uyarısı hem de yeniden bağlantı geçişi stderr'de {"type":"notice"} kayıtları olarak üretilir. Kurtarılamaz hatalar (kimlik doğrulama hatası, hatalı yapılandırma) yine de hemen çıkar.
--follow --json modunda günlük kaynağı geçişleri {"type":"meta"} kayıtları olarak üretilir. Tüketiciler imleçleri her sourceKind için ayrı izlemelidir: bir akış Gateway dosya çıktısından (sourceKind: "file") yerel günlük geri dönüşüne (sourceKind: "journal", localFallback: true, service.pid/service.unit ile) geçebilir ve kurtarma sonrasında yeniden Gateway dosya çıktısına dönebilir. Tüm takip oturumu boyunca tek bir kararlı kaynak veya imleç varsaymayın ve kurtarma Gateway dosya imlecini yeniden oynattığında çakışan satırları tolere edin.

İlgili

Was this useful?