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

## Ротационный файл журнала диагностики (панель отладки)

OpenClaw направляет журналы приложения macOS через swift-log (по умолчанию используется unified logging) и может записывать локальный ротационный файловый журнал на диск, когда нужен долговременный захват.

* Подробность: **Панель отладки → Журналы → Журналирование приложения → Подробность**
* Включение: **Панель отладки → Журналы → Журналирование приложения → "Записывать ротационный журнал диагностики (JSONL)"**
* Расположение: `~/Library/Logs/OpenClaw/diagnostics.jsonl` (ротируется автоматически; старые файлы получают суффиксы `.1`, `.2`, …)
* Очистка: **Панель отладки → Журналы → Журналирование приложения → "Очистить"**

Примечания:

* По умолчанию это **выключено**. Включайте только во время активной отладки.
* Считайте файл конфиденциальным; не передавайте его без проверки.

## Конфиденциальные данные в unified logging на macOS

Unified logging скрывает большинство полезных нагрузок, если подсистема не включает `privacy -off`. Согласно заметке Peter о [каверзах конфиденциальности журналирования](https://steipete.me/posts/2025/logging-privacy-shenanigans) в macOS (2025), это управляется plist-файлом в `/Library/Preferences/Logging/Subsystems/`, ключом служит имя подсистемы. Флаг применяется только к новым записям журнала, поэтому включите его перед воспроизведением проблемы.

## Включение для 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`.

## Отключение после отладки

* Удалите переопределение: `sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist`.
* При желании выполните `sudo log config --reload`, чтобы принудительно заставить logd немедленно отбросить переопределение.
* Помните, что эта поверхность может включать номера телефонов и тела сообщений; оставляйте plist на месте только пока вам активно нужны дополнительные детали.

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

* [Приложение macOS](/ru/platforms/macos)
* [Журналирование Gateway](/ru/gateway/logging)