Skip to main content

​
Rejestrowanie (macOS)

​
Rotacyjny plik dziennika diagnostycznego (panel debugowania)

Aplikacja dla macOS rejestruje zdarzenia za pomocą swift-log (domyślnie w ujednoliconym systemie rejestrowania), a także może zapisywać rotacyjny lokalny plik dziennika w celu trwałego przechwytywania danych (DiagnosticsFileLog).
  • Włączanie: Debug pane -> Logs -> App logging -> “Write rolling diagnostics log (JSONL)” (domyślnie wyłączone).
  • Szczegółowość: selektor Debug pane -> Logs -> App logging -> Verbosity.
  • Lokalizacja: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotacja: następuje po osiągnięciu 5 MB; maksymalnie 5 kopii zapasowych z przyrostkami .1….5 (najstarsza jest usuwana).
  • Czyszczenie: Debug pane -> Logs -> App logging -> “Clear” usuwa aktywny plik i wszystkie kopie zapasowe.
Traktuj ten plik jako poufny; nie udostępniaj go bez uprzedniego sprawdzenia.

​
Prywatne dane w ujednoliconym systemie rejestrowania w macOS

Ujednolicony system rejestrowania ukrywa większość danych ładunku, chyba że podsystem włączy opcję privacy -off. Jest to kontrolowane przez plik plist w katalogu /Library/Preferences/Logging/Subsystems/, którego kluczem jest nazwa podsystemu. Flaga ma zastosowanie tylko do nowych wpisów dziennika, dlatego włącz ją przed odtworzeniem problemu. Więcej informacji: zawiłości prywatności rejestrowania w macOS.

​
Włączanie dla OpenClaw (ai.openclaw)

Najpierw zapisz plik plist w pliku tymczasowym, a następnie zainstaluj go atomowo jako użytkownik root:
Ponowne uruchomienie nie jest wymagane; logd szybko wykrywa plik, ale tylko nowe wiersze dziennika zawierają prywatne dane ładunku. Bardziej szczegółowe dane wyjściowe można wyświetlić za pomocą ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l ustawia zakres czasu, domyślnie 5m; --category/-c filtruje według kategorii).

​
Wyłączanie po zakończeniu debugowania

  • Usuń nadpisanie: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Opcjonalnie uruchom sudo log config --reload, aby wymusić natychmiastowe odrzucenie nadpisania przez logd.
  • Ten mechanizm może ujawniać numery telefonów i treść wiadomości; pozostaw plik plist tylko na czas, gdy jest aktywnie potrzebny.

​
Powiązane