Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw może utworzyć lokalny plik zip diagnostyki do zgłoszeń błędów. Łączy oczyszczony status Gateway, kondycję, logi, kształt konfiguracji oraz ostatnie zdarzenia stabilności bez payloadów. Traktuj pakiety diagnostyczne jak sekrety, dopóki ich nie przejrzysz. Zostały zaprojektowane tak, aby pomijać lub redagować payloady i dane uwierzytelniające, ale nadal podsumowują lokalne logi Gateway oraz stan środowiska uruchomieniowego na poziomie hosta.

​
Szybki start

openclaw gateway diagnostics export
Polecenie wypisuje ścieżkę zapisanego pliku zip. Aby wybrać ścieżkę: 
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
Do automatyzacji: 
openclaw gateway diagnostics export --json

​
Polecenie czatu

Właściciele mogą użyć /diagnostics [note] na czacie, aby zażądać lokalnego eksportu Gateway. Użyj tego, gdy błąd wystąpił w prawdziwej rozmowie i chcesz mieć jeden raport możliwy do skopiowania i wklejenia dla pomocy technicznej:
  1. Wyślij /diagnostics w rozmowie, w której zauważono problem. Dodaj krótką notatkę, jeśli to pomaga, na przykład /diagnostics bad tool choice.
  2. OpenClaw wysyła preambułę diagnostyki i prosi o jedną jawną zgodę na exec. Zgoda uruchamia openclaw gateway diagnostics export --json. Nie zatwierdzaj diagnostyki za pomocą reguły zezwalającej na wszystko.
  3. Po zatwierdzeniu OpenClaw odpowiada raportem do wklejenia, zawierającym lokalną ścieżkę pakietu, podsumowanie manifestu, uwagi dotyczące prywatności oraz odpowiednie identyfikatory sesji.
W czatach grupowych właściciel nadal może uruchomić /diagnostics, ale OpenClaw nie publikuje szczegółów diagnostycznych z powrotem na wspólnym czacie. Wysyła preambułę, monity zatwierdzenia, wynik eksportu Gateway oraz rozbicie sesji/wątków Codex do właściciela przez prywatną ścieżkę zatwierdzeń. Grupa otrzymuje tylko krótkie powiadomienie, że przepływ diagnostyki został wysłany prywatnie. Jeśli OpenClaw nie może znaleźć prywatnej ścieżki do właściciela, polecenie kończy się bezpiecznym niepowodzeniem i prosi właściciela o uruchomienie go z wiadomości prywatnej. Gdy aktywna sesja OpenClaw używa natywnego harnessa OpenAI Codex, ta sama zgoda na exec obejmuje także przesłanie opinii do OpenAI dla wątków środowiska uruchomieniowego Codex, o których wie OpenClaw. To przesłanie jest oddzielne od lokalnego pliku zip Gateway i pojawia się tylko dla sesji harnessa Codex. Przed zatwierdzeniem monit wyjaśnia, że zatwierdzenie diagnostyki wyśle także opinię Codex, ale nie wyświetla identyfikatorów sesji ani wątków Codex. Po zatwierdzeniu odpowiedź na czacie wymienia kanały, identyfikatory sesji OpenClaw, identyfikatory wątków Codex oraz lokalne polecenia wznowienia dla wątków wysłanych na serwery OpenAI. Jeśli odmówisz zatwierdzenia albo je zignorujesz, OpenClaw nie uruchamia eksportu, nie wysyła opinii Codex i nie wypisuje identyfikatorów Codex. Dzięki temu typowa pętla debugowania Codex jest krótka: zauważ nieprawidłowe zachowanie w Telegram, Discord lub innym kanale, uruchom /diagnostics, zatwierdź raz, udostępnij raport pomocy technicznej, a następnie uruchom wypisane polecenie codex resume <thread-id> lokalnie, jeśli chcesz samodzielnie sprawdzić natywny wątek Codex. Zobacz harness Codex, aby poznać ten przepływ inspekcji.

​
Co zawiera eksport

Plik zip zawiera:
  • summary.md: czytelny dla człowieka przegląd dla pomocy technicznej.
  • diagnostics.json: czytelne maszynowo podsumowanie konfiguracji, logów, statusu, kondycji i danych stabilności.
  • manifest.json: metadane eksportu i lista plików.
  • Oczyszczony kształt konfiguracji i niesekretne szczegóły konfiguracji.
  • Oczyszczone podsumowania logów i ostatnie zredagowane wiersze logów.
  • Najlepsze możliwe migawki statusu i kondycji Gateway.
  • stability/latest.json: najnowszy utrwalony pakiet stabilności, jeśli jest dostępny.
Eksport jest przydatny nawet wtedy, gdy Gateway jest w złej kondycji. Jeśli Gateway nie może odpowiedzieć na żądania statusu lub kondycji, lokalne logi, kształt konfiguracji i najnowszy pakiet stabilności nadal są zbierane, gdy są dostępne.

​
Model prywatności

Diagnostyka została zaprojektowana tak, aby można było ją udostępniać. Eksport zachowuje dane operacyjne, które pomagają w debugowaniu, takie jak:
  • nazwy podsystemów, identyfikatory pluginów, identyfikatory dostawców, identyfikatory kanałów i skonfigurowane tryby
  • kody statusu, czasy trwania, liczby bajtów, stan kolejki i odczyty pamięci
  • oczyszczone metadane logów i zredagowane komunikaty operacyjne
  • kształt konfiguracji i niesekretne ustawienia funkcji
Eksport pomija lub redaguje:
  • tekst czatu, monity, instrukcje, treści Webhook i dane wyjściowe narzędzi
  • dane uwierzytelniające, klucze API, tokeny, pliki cookie i wartości sekretów
  • surowe treści żądań lub odpowiedzi
  • identyfikatory kont, identyfikatory wiadomości, surowe identyfikatory sesji, nazwy hostów i lokalne nazwy użytkowników
Gdy komunikat logu wygląda jak tekst użytkownika, czatu, monitu lub payloadu narzędzia, eksport zachowuje tylko informację, że komunikat został pominięty, oraz liczbę bajtów.

​
Rejestrator stabilności

Gateway domyślnie rejestruje ograniczony, pozbawiony payloadów strumień stabilności, gdy diagnostyka jest włączona. Służy on do faktów operacyjnych, a nie do treści. Ten sam diagnostyczny Heartbeat rejestruje próbki żywotności, gdy Gateway nadal działa, ale pętla zdarzeń Node.js lub CPU wygląda na przeciążoną. Te zdarzenia diagnostic.liveness.warning obejmują opóźnienie pętli zdarzeń, wykorzystanie pętli zdarzeń, stosunek do rdzeni CPU, liczby aktywnych/oczekujących/w kolejce sesji, bieżącą fazę startu/środowiska uruchomieniowego, gdy jest znana, ostatnie przedziały faz oraz ograniczone etykiety aktywnych i zakolejkowanych prac. Próbki bezczynności pozostają w telemetrii na poziomie info. Próbki żywotności stają się ostrzeżeniami Gateway tylko wtedy, gdy praca czeka lub jest w kolejce, albo gdy aktywna praca nakłada się na utrzymujące się opóźnienie pętli zdarzeń. Przejściowe skoki maksymalnego opóźnienia podczas poza tym zdrowej pracy w tle pozostają w logach debugowania. Same z siebie nie restartują Gateway. Fazy startu emitują również zdarzenia diagnostic.phase.completed z czasem zegarowym i czasem CPU. Zatrzymana diagnostyka osadzonego uruchomienia oznacza terminalProgressStale=true, gdy ostatni postęp mostka wyglądał na końcowy, na przykład surowy element odpowiedzi lub zdarzenie ukończenia odpowiedzi, ale Gateway nadal uważa osadzone uruchomienie za aktywne. Sprawdź działający rejestrator: 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
Sprawdź najnowszy utrwalony pakiet stabilności po krytycznym zakończeniu, przekroczeniu czasu zamykania lub błędzie startu po restarcie: 
openclaw gateway stability --bundle latest
Utwórz plik zip diagnostyki z najnowszego utrwalonego pakietu: 
openclaw gateway stability --bundle latest --export
Utrwalone pakiety znajdują się w ~/.openclaw/logs/stability/, gdy istnieją zdarzenia.

​
Przydatne opcje

openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
  • --output <path>: zapisz do konkretnej ścieżki zip.
  • --log-lines <count>: maksymalna liczba oczyszczonych wierszy logów do uwzględnienia.
  • --log-bytes <bytes>: maksymalna liczba bajtów logów do sprawdzenia.
  • --url <url>: adres URL WebSocket Gateway dla migawek statusu i kondycji.
  • --token <token>: token Gateway dla migawek statusu i kondycji.
  • --password <password>: hasło Gateway dla migawek statusu i kondycji.
  • --timeout <ms>: limit czasu migawki statusu i kondycji.
  • --no-stability-bundle: pomiń wyszukiwanie utrwalonego pakietu stabilności.
  • --json: wypisz czytelne maszynowo metadane eksportu.

​
Wyłącz diagnostykę

Diagnostyka jest domyślnie włączona. Aby wyłączyć rejestrator stabilności i zbieranie zdarzeń diagnostycznych: 
{
  diagnostics: {
    enabled: false,
  },
}
Wyłączenie diagnostyki zmniejsza szczegółowość zgłoszeń błędów. Nie wpływa na normalne logowanie Gateway.

​
Powiązane