Перейти к основному содержимому

Сопутствующее приложение для macOS

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

Ротируемый файл журнала диагностики (Панель отладки)​

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

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

Примечания:

  • Эта функция по умолчанию отключена. Включайте её только во время активной отладки.
  • Относитесь к файлу как к конфиденциальному; не делитесь им без предварительной проверки.

Приватные данные в унифицированном ведении журналов macOS​

Унифицированное ведение журналов скрывает большинство полезных данных, если подсистема явно не разрешит это с помощью privacy -off. Как описано в статье Питера о уловках приватности в ведении журналов macOS (2025), это контролируется файлом plist в /Library/Preferences/Logging/Subsystems/, ключом которого является имя подсистемы. Флаг применяется только к новым записям журнала, поэтому включите его до воспроизведения проблемы.

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

  • Сначала запишите plist во временный файл, затем установите его атомарно от имени root:
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