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)

Циклический файл журнала диагностики (панель 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:

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