Skip to main content

​
로깅(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를 작성한 다음, 루트 권한으로 원자적으로 설치합니다.
재부팅은 필요하지 않습니다. 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를 유지하세요.

​
관련 문서