> ## 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.

# Ведение журналов в 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](https://steipete.me/posts/2025/logging-privacy-shenanigans).

## Включение для OpenClaw (`ai.openclaw`)

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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>
EOF
sudo 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 установленным только на время, когда он действительно необходим.

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

* [Приложение macOS](https://docs2.openclaw.ai/ru/platforms/macos.md)
* [Ведение журналов Gateway](https://docs2.openclaw.ai/ru/gateway/logging.md)