로깅(macOS)

순환 진단 파일 로그(디버그 창)

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.
• 순환: 5MB에서 순환하며, .1....5 접미사가 붙은 백업을 최대 5개까지 유지합니다(가장 오래된 백업은 삭제됨).
• 지우기: **Debug pane -> Logs -> App logging -> "Clear"**는 활성 파일과 모든 백업을 삭제합니다.

이 파일은 민감한 정보로 취급하고, 검토 없이 공유하지 마세요.

macOS 통합 로깅의 비공개 데이터

통합 로깅은 하위 시스템에서 privacy -off를 사용하도록 설정하지 않는 한 대부분의 페이로드를 가립니다. 이 설정은 /Library/Preferences/Logging/Subsystems/에 있으며 하위 시스템 이름을 키로 사용하는 plist로 제어됩니다. 새 로그 항목에만 이 플래그가 적용되므로 문제를 재현하기 전에 활성화하세요. 배경 정보: macOS 로깅 개인정보 보호 관련 문제.

OpenClaw(ai.openclaw)에 활성화

먼저 임시 파일에 plist를 작성한 다음, 루트 권한으로 원자적으로 설치합니다.

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를 유지하세요.

관련 문서

• macOS 앱
• Gateway 로깅