OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

Журналювання macOS

Журналювання (macOS)

Файл журналу циклічної діагностики (панель налагодження)

Застосунок macOS веде журнал через swift-log (типово використовується уніфіковане журналювання), а також може записувати циклічний локальний файл журналу для довготривалого збереження даних (DiagnosticsFileLog).

  • Увімкнення: Debug pane -> Logs -> App logging -> "Write rolling diagnostics log (JSONL)" (типово вимкнено).
  • Деталізація: засіб вибору Debug pane -> Logs -> App logging -> Verbosity.
  • Розташування: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Ротація: виконується за розміру 5 МБ; зберігається до 5 резервних копій із суфіксами .1....5 (найстарішу видаляють).
  • Очищення: Debug pane -> Logs -> App logging -> "Clear" видаляє активний файл і всі резервні копії.

Вважайте цей файл конфіденційним; не поширюйте його без попередньої перевірки.

Приватні дані в уніфікованому журналі macOS

Уніфіковане журналювання приховує більшість корисних даних, якщо для підсистеми не ввімкнено privacy -off. Це налаштування контролюється файлом plist у /Library/Preferences/Logging/Subsystems/, ключем якого є назва підсистеми. Прапорець застосовується лише до нових записів журналу, тому ввімкніть його перед відтворенням проблеми. Докладніше: особливості конфіденційності журналювання macOS.

Увімкнення для OpenClaw (ai.openclaw)

Спочатку запишіть plist у тимчасовий файл, а потім атомарно встановіть його з правами root:

bash
cat <<'EOF' >/tmp/ai.openclaw.plist<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>DEFAULT-OPTIONS</key>    <dict>        <key>Enable-Private-Data</key>        <true/>    </dict></dict></plist>EOFsudo install -m 644 -o root -g wheel /tmp/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plist

Перезавантаження не потрібне; logd швидко підхоплює файл, але приватні корисні дані міститимуть лише нові рядки журналу. Переглядайте докладніший вивід за допомогою ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l задає діапазон часу, типове значення — 5m; --category/-c фільтрує за категорією).

Вимкнення після налагодження

  • Видаліть перевизначення: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • За потреби виконайте sudo log config --reload, щоб змусити logd негайно скинути перевизначення.
  • Ці дані можуть містити номери телефонів і тексти повідомлень; залишайте plist установленим лише тоді, коли він активно потрібен.

Пов’язані матеріали

Was this useful?
On this page

On this page