Skip to main content

​
Ведение журналов (macOS)

​
Циклический файл журнала диагностики (панель Debug)

Приложение 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:
Перезагрузка не требуется; 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 установленным только на время, когда он действительно необходим.

​
Связанные материалы