Hızlı başlangıç
Sohbet komutu
Sahipler yerel Gateway dışa aktarımı istemek için sohbette/diagnostics [note] kullanabilir.
Bunu hata gerçek bir konuşmada gerçekleştiğinde ve destek için
kopyalanıp yapıştırılabilir tek bir rapor istediğinizde kullanın:
- Sorunu fark ettiğiniz konuşmada
/diagnosticsgönderin. Yardımcı olacaksa kısa bir not ekleyin, örneğin/diagnostics bad tool choice. - OpenClaw tanılama giriş metnini gönderir ve bir açık çalıştırma
onayı ister. Onay
openclaw gateway diagnostics export --jsonkomutunu çalıştırır. Tanılamayı tümüne izin verme kuralı üzerinden onaylamayın. - Onaydan sonra OpenClaw yerel paket yolunu, manifest özetini, gizlilik notlarını ve ilgili oturum kimliklerini içeren yapıştırılabilir bir raporla yanıt verir.
/diagnostics çalıştırabilir, ancak OpenClaw
tanılama ayrıntılarını paylaşılan sohbete geri göndermez. Giriş metnini,
onay istemlerini, Gateway dışa aktarma sonucunu ve Codex oturum/iş parçacığı dökümünü
özel onay yolu üzerinden sahibine gönderir. Grup yalnızca tanılama akışının özel olarak
gönderildiğine dair kısa bir bildirim alır. OpenClaw özel bir sahip yolu bulamazsa,
komut güvenli şekilde başarısız olur ve sahibinden bunu bir DM üzerinden çalıştırmasını ister.
Etkin OpenClaw oturumu yerel OpenAI Codex harness kullanıyorsa,
aynı çalıştırma onayı OpenClaw’ın bildiği Codex çalışma zamanı iş parçacıkları için
bir OpenAI geri bildirim yüklemesini de kapsar. Bu yükleme yerel
Gateway zip dosyasından ayrıdır ve yalnızca Codex harness oturumları için görünür. Onaydan önce istem,
tanılamayı onaylamanın Codex geri bildirimi de göndereceğini açıklar, ancak
Codex oturum veya iş parçacığı kimliklerini listelemez. Onaydan sonra sohbet yanıtı,
OpenAI sunucularına 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ı reddeder veya yok sayarsanız,
OpenClaw dışa aktarımı çalıştırmaz, Codex geri bildirimi göndermez ve
Codex kimliklerini yazdırmaz.
Bu, yaygın Codex hata ayıklama döngüsünü kısaltır: Telegram, Discord veya başka bir kanalda
kötü davranışı fark edin, /diagnostics çalıştırın, bir kez onaylayın, raporu
destekle paylaşın, ardından yerel Codex iş parçacığını kendiniz incelemek istiyorsanız
yazdırılan codex resume <thread-id> komutunu yerel olarak çalıştırın. Bu inceleme iş akışı için
Codex harness bölümüne bakın.
Dışa aktarımın içerikleri
Zip şunları içerir:summary.md: destek için insan tarafından okunabilir genel bakış.diagnostics.json: yapılandırma, günlükler, durum, sağlık ve kararlılık verilerinin makine tarafından okunabilir özeti.manifest.json: dışa aktarma meta verileri ve dosya listesi.- Temizlenmiş yapılandırma şekli ve gizli olmayan yapılandırma ayrıntıları.
- Temizlenmiş günlük özetleri ve yakın tarihli maskelemiş günlük satırları.
- En iyi çabayla alınan Gateway durum ve sağlık anlık görüntüleri.
stability/latest.json: kullanılabilir olduğunda en yeni kalıcı kararlılık paketi.
Gizlilik modeli
Tanılamalar paylaşılabilir olacak şekilde tasarlanmıştır. Dışa aktarım hata ayıklamaya yardım eden operasyonel verileri korur, örneğin:- alt sistem adları, plugin kimlikleri, sağlayıcı kimlikleri, kanal kimlikleri ve yapılandırılmış modlar
- durum kodları, süreler, bayt sayıları, kuyruk durumu ve bellek okumaları
- temizlenmiş günlük meta verileri ve maskelemiş operasyonel mesajlar
- yapılandırma şekli ve gizli olmayan özellik ayarları
- sohbet metni, istemler, talimatlar, webhook gövdeleri ve araç çıktıları
- kimlik bilgileri, API anahtarları, token’lar, çerezler ve gizli değerler
- ham istek veya yanıt gövdeleri
- hesap kimlikleri, mesaj kimlikleri, ham oturum kimlikleri, ana makine adları ve yerel kullanıcı adları
Kararlılık kaydedici
Gateway, tanılama etkinleştirildiğinde varsayılan olarak sınırlandırılmış, yük içermeyen bir kararlılık akışı kaydeder. Bu, içerik için değil operasyonel olgular içindir. Aynı tanılama heartbeat, Gateway çalışmaya devam ederken ancak Node.js olay döngüsü veya CPU doygun göründüğünde canlılık örnekleri kaydeder. Budiagnostic.liveness.warning olayları olay döngüsü gecikmesini, olay döngüsü
kullanımını, CPU çekirdeği oranını, etkin/bekleyen/kuyrukta oturum sayılarını, biliniyorsa geçerli
başlatma/çalışma zamanı aşamasını, yakın tarihli aşama aralıklarını ve sınırlandırılmış etkin/kuyrukta
iş etiketlerini içerir. Boşta örnekleri telemetride info düzeyinde kalır. Canlılık örnekleri
yalnızca iş beklerken veya kuyruktayken ya da etkin iş sürekli olay döngüsü gecikmesiyle
çakıştığında Gateway uyarılarına dönüşür. Aksi halde sağlıklı arka plan işi sırasında oluşan
geçici en yüksek gecikme sıçramaları hata ayıklama günlüklerinde kalır. Bunlar Gateway’i
kendiliğinden yeniden başlatmaz.
Başlatma aşamaları ayrıca duvar saati ve CPU zamanlamasıyla diagnostic.phase.completed
olayları yayar. Takılmış gömülü çalıştırma tanılamaları, son köprü ilerlemesi ham yanıt öğesi veya
yanıt tamamlama olayı gibi terminal göründüğünde, ancak Gateway gömülü çalıştırmayı hâlâ etkin
kabul ettiğinde terminalProgressStale=true olarak işaretler.
Canlı kaydediciyi inceleyin:
~/.openclaw/logs/stability/ altında bulunur.
Kullanışlı seçenekler
--output <path>: belirli bir zip yoluna yaz.--log-lines <count>: eklenecek en fazla temizlenmiş günlük satırı sayısı.--log-bytes <bytes>: incelenecek en fazla günlük baytı.--url <url>: durum ve sağlık anlık görüntüleri için Gateway WebSocket URL’si.--token <token>: durum ve sağlık anlık görüntüleri için Gateway token’ı.--password <password>: durum ve sağlık anlık görüntüleri için Gateway parolası.--timeout <ms>: durum ve sağlık anlık görüntüsü zaman aşımı.--no-stability-bundle: kalıcı kararlılık paketi aramasını atla.--json: makine tarafından okunabilir dışa aktarma meta verilerini yazdır.
Tanılamayı devre dışı bırakma
Tanılama varsayılan olarak etkindir. Kararlılık kaydediciyi ve tanılama olayı toplamayı devre dışı bırakmak için:İlgili
- Sağlık denetimleri
- Gateway CLI
- Gateway protokolü
- Günlük kaydı
- OpenTelemetry dışa aktarma — tanılamaları bir toplayıcıya akışla göndermek için ayrı akış