Skip to main content
OpenClaw, hata raporları için yerel bir tanılama .zip oluşturabilir: arındırılmış Gateway durumu, sistem sağlığı, günlükler, yapılandırma şekli ve yük içermeyen son kararlılık olayları. İncelenene kadar tanılama paketlerine gizli bilgiler gibi davranın. Yükler ve kimlik bilgileri tasarım gereği sansürlenir, ancak paket yine de yerel Gateway günlüklerini ve ana makine düzeyindeki çalışma zamanı durumunu özetler.

Hızlı başlangıç

Yazılan zip dosyasının yolunu görüntüler. Bir çıktı yolu seçin:
Otomasyon için:

Sohbet komutu

Sahipler, tek parça hâlinde kopyalanıp yapıştırılabilen bir destek raporu olarak yerel bir Gateway dışa aktarımı istemek için herhangi bir konuşmada /diagnostics [note] çalıştırabilir:
  1. /diagnostics gönderin; isteğe bağlı olarak kısa bir not ekleyin (/diagnostics bad tool choice).
  2. OpenClaw bir ön açıklama gönderir ve openclaw gateway diagnostics export --json komutunu çalıştıran tek bir açık yürütme onayı ister. Tanılamayı tümüne izin veren bir kural aracılığıyla onaylamayın.
  3. Onaydan sonra OpenClaw; yerel paket yolu, bildirim özeti, gizlilik notları ve ilgili oturum kimlikleriyle yanıt verir.
Grup sohbetlerinde bir sahip yine de /diagnostics çalıştırabilir, ancak OpenClaw dışa aktarma sonucunu, onay istemlerini ve Codex oturum/iş parçacığı dökümünü sahibe özel olarak gönderir. Grup yalnızca tanılamanın özel olarak gönderildiğini belirten kısa bir bildirim görür. Sahibe ulaşan özel bir yol yoksa komut güvenli biçimde başarısız olur ve sahibin komutu bir DM üzerinden çalıştırmasını ister. Etkin oturum yerel OpenAI Codex koşum takımını kullandığında, aynı yürütme onayı OpenClaw’ın bildiği Codex iş parçacıkları için OpenAI’a geri bildirim yüklenmesini de kapsar. Bu yükleme yerel Gateway zip dosyasından ayrıdır ve yalnızca Codex koşum takımı oturumlarında gerçekleşir. Onay istemi, onaylamanın Codex oturum veya iş parçacığı kimliklerini listelemeden Codex geri bildirimini de göndereceğini belirtir. Onaydan sonra yanıt; OpenAI’a gönderilen iş parçacıkları için kanalları, OpenClaw oturum kimliklerini, Codex iş parçacığı kimliklerini ve yerel sürdürme komutlarını listeler. Onayın reddedilmesi veya yok sayılması; dışa aktarımı, Codex geri bildirim yüklemesini ve Codex kimlik listesini atlar. Bu, Codex hata ayıklama döngüsünü kısaltır: bir kanalda hatalı davranışı fark edin, /diagnostics çalıştırın, bir kez onaylayın, raporu paylaşın ve ardından iş parçacığını kendiniz incelemek istiyorsanız görüntülenen codex resume <thread-id> komutunu yerel olarak çalıştırın. Bkz. Codex koşum takımı.

Dışa aktarımın içeriği

  • summary.md: destek için insanlar tarafından okunabilir genel bakış.
  • diagnostics.json: yapılandırma, günlükler, durum, sistem sağlığı ve kararlılık verilerinin makine tarafından okunabilir özeti.
  • manifest.json: dışa aktarma meta verileri ve dosya listesi.
  • Arındırılmış yapılandırma şekli ve gizli olmayan yapılandırma ayrıntıları.
  • Arındırılmış günlük özetleri ve sansürlenmiş son günlük satırları.
  • Olanaklar dâhilinde alınan Gateway durum ve sistem sağlığı anlık görüntüleri.
  • stability/latest.json: mevcut olduğunda kalıcı hâle getirilmiş en yeni kararlılık paketi.
Dışa aktarım, Gateway sağlıksız olduğunda da yararlıdır: durum/sistem sağlığı istekleri başarısız olursa yerel günlükler, yapılandırma şekli ve en son kararlılık paketi mevcut olduklarında yine toplanır.

Gizlilik modeli

Saklananlar: alt sistem adları, plugin kimlikleri, sağlayıcı kimlikleri, kanal kimlikleri, yapılandırılmış modlar, durum kodları, süreler, bayt sayıları, kuyruk durumu, bellek okumaları, arındırılmış günlük meta verileri, sansürlenmiş operasyonel mesajlar, yapılandırma şekli ve gizli olmayan özellik ayarları. Atlanan veya sansürlenenler: sohbet metni, istemler, talimatlar, webhook gövdeleri, araç çıktıları, kimlik bilgileri, API anahtarları, belirteçler, çerezler, gizli değerler, ham istek/yanıt gövdeleri, hesap kimlikleri, mesaj kimlikleri, ham oturum kimlikleri, ana makine adları ve yerel kullanıcı adları. Bir günlük mesajı kullanıcı, sohbet, istem veya araç yükü metni gibi göründüğünde dışa aktarım yalnızca bir mesajın atlandığı bilgisini ve bayt sayısını saklar.

Kararlılık kaydedicisi

Gateway, tanılama etkinleştirildiğinde varsayılan olarak sınırlı ve yük içermeyen bir kararlılık akışı kaydeder. İçeriği değil, operasyonel olguları yakalar. Aynı heartbeat, olay döngüsü veya CPU doygun göründüğünde canlılığı da örnekleyerek olay döngüsü gecikmesi, olay döngüsü kullanımı, CPU çekirdeği oranı, etkin/bekleyen/kuyruğa alınmış oturum sayıları, geçerli başlatma/çalışma zamanı aşaması (biliniyorsa), son aşama aralıkları ve sınırlı iş etiketleri içeren diagnostic.liveness.warning olaylarını yayınlar. Bunlar yalnızca iş bekliyorsa veya kuyruğa alınmışsa ya da etkin iş sürekli olay döngüsü gecikmesiyle çakışıyorsa Gateway warn düzeyinde günlük satırlarına dönüşür; aksi takdirde debug düzeyinde günlüğe kaydedilir. Boştaki canlılık örnekleri yine tanılama olayları olarak kaydedilir, ancak tek başlarına hiçbir zaman uyarı düzeyine yükseltilmez. Başlatma aşamaları, duvar saati ve CPU zamanlamasıyla diagnostic.phase.completed olaylarını yayınlar. Takılı kalan gömülü çalıştırma tanılamaları, son köprü ilerlemesi sonlandırıcı görünüyorsa (örneğin ham bir yanıt öğesi veya yanıt tamamlama olayı) ancak Gateway gömülü çalıştırmayı hâlâ etkin kabul ediyorsa terminalProgressStale=true işaretini ekler. Canlı kaydediciyi inceleyin:
Önemli bir çıkış, kapatma zaman aşımı veya yeniden başlatma hatasından sonra kalıcı hâle getirilmiş en yeni paketi inceleyin:
Kalıcı hâle getirilmiş en yeni paketten bir tanılama zip dosyası oluşturun:
Olaylar mevcut olduğunda kalıcı paketler ~/.openclaw/logs/stability/ altında bulunur.

Yararlı seçenekler

Tanılamayı devre dışı bırakma

Tanılama varsayılan olarak etkindir. Kararlılık kaydedicisini ve tanılama olayı toplamayı devre dışı bırakmak için:
Tanılamanın devre dışı bırakılması hata raporu ayrıntılarını azaltır; normal Gateway günlük kaydını etkilemez. Bellek baskısı olayları, dosya sistemi taraması yapmadan veya OOM öncesi anlık görüntü yazmadan RSS, yığın, eşik ve büyüme olgularını (rss_threshold, heap_threshold, rss_growth) kaydeder.

İlgili konular