CLI commands

Günlükler

`openclaw logs`

Gateway dosya günlüklerinin sonunu RPC üzerinden izler. Uzak modda çalışır.

Seçenekler

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

Paylaşılan Gateway RPC seçenekleri

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

--url iletildiğinde otomatik uygulanan yapılandırma kimlik bilgileri atlanır; hedef Gateway kimlik doğrulaması gerektiriyorsa --token seçeneğini 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 --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Geri dönüş ve kurtarma davranışı

Ö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, yapılandırılmış Gateway dosya günlüğüne otomatik olarak geri döner. Açıkça belirtilen --url hedefleri bu geri dönüşü hiçbir zaman kullanmaz.
--follow, örtük yerel Gateway RPC hatasından sonra yapılandırılmış dosyaya geri dönmez; güncelliğini yitirmiş yan yana bir dosya, canlı son izleme sırasında yanıltıcı olabilir. Linux'ta bunun yerine, kullanılabiliyorsa etkin kullanıcı systemd Gateway günlüğünü PID'ye göre kullanır (seçilen kaynağı yazdırır); aksi takdirde canlı Gateway'e yeniden bağlanmayı sürdürür.
--follow sırasında geçici bağlantı kesintileri (WebSocket kapanması, zaman aşımı, bağlantının kopması), üstel geri çekilmeyle otomatik yeniden bağlantıyı tetikler: en fazla 8 yeniden deneme ve denemeler arasında en fazla 30 saniye. Her yeniden denemede stderr'e bir uyarı yazdırılır ve bir yoklama başarılı olduğunda bir kez [logs] gateway reconnected bildirimi yazdırılır. --json modunda her ikisi de stderr'de {"type":"notice"} kayıtları olarak üretilir. Kurtarılamayan hatalarda (kimlik doğrulama hatası, geçersiz yapılandırma) işlem yine hemen sonlandırılır.
--follow --json modunda günlük kaynağı geçişleri {"type":"meta"} kayıtları olarak üretilir. İmleçleri her sourceKind için ayrı ayrı izleyin: 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çip kurtarmadan sonra tekrar Gateway dosya çıktısına dönebilir. Oturumun tamamı boyunca tek ve sabit bir kaynak veya imleç bulunduğunu varsaymayın; kurtarma işlemi Gateway dosya imlecini yeniden oynattığında örtüşen satırlara tolerans gösterin.

İlgili konular

Was this useful?