macOS에서 OpenClaw 로그 제대로 확인하기

개발을 하다 보면 가장 답답한 순간이 있죠. 분명히 문제가 생겼는데 로그에는 아무런 정보가 없거나, 정작 중요한 데이터가 보안 때문에 가려져 있을 때예요. 로그가 불친절하면 원인 파악에만 몇 시간을 허비하게 됩니다.

OpenClaw에서 발생하는 복잡한 문제를 해결하려면 앱 내부의 진단 로그와 macOS 시스템 로그를 모두 살펴봐야 해요. 효율적인 디버깅을 위해 로그 설정을 최적화하는 방법을 정리했습니다.

필요한 것

• macOS 환경
• OpenClaw 앱
• 터미널 접근 및 sudo 권한

빠른 시작

5분 안에 진단 로그를 활성화하고 상세한 데이터를 확인하는 방법이에요.

1. 순환 진단 로그 활성화

앱 내부의 상세 동작을 파일로 기록하려면 Debug pane에서 설정을 변경해야 해요.

• 로그 수준 설정: Debug pane → Logs → App logging → Verbosity
• 파일 기록 활성화: Debug pane → Logs → App logging → “Write rolling diagnostics log (JSONL)” 체크
• 파일 위치: ~/Library/Logs/OpenClaw/diagnostics.jsonl

이 파일은 자동으로 로테이션되며, 오래된 파일은 뒤에 .1, .2 같은 숫자가 붙습니다. 디버깅이 끝나면 “Clear” 버튼을 눌러 로그를 정리할 수 있어요.

2. 가려진 Private Data 확인하기

macOS의 Unified logging은 보안을 위해 대부분의 페이로드를 <private>으로 표시해요. OpenClaw(bot.molt)의 상세 로그를 보려면 아래 명령어를 터미널에 복사해서 실행하세요.

cat <<'EOF' >/tmp/bot.molt.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/bot.molt.plist /Library/Preferences/Logging/Subsystems/bot.molt.plist

재부팅은 필요 없지만, 설정 이후에 생성되는 새로운 로그부터 데이터가 표시됩니다. 아래 헬퍼 스크립트로 로그를 확인해 보세요.

./scripts/clawlog.sh --category WebChat --last 5m

문제 해결

로그를 설정하면서 마주칠 수 있는 상황들입니다.

• 로그에 여전히 <private>이 표시됨: 설정 파일 설치 이전에 기록된 로그는 소급 적용되지 않아요. 설정을 완료한 후 문제를 다시 재현해서 새로운 로그를 확인하세요.
• 로그 파일이 너무 커짐: 진단 로그 기록은 기본적으로 꺼져 있습니다. 디버깅 중에만 켜두고, 평소에는 꺼두는 것을 권장해요.

Disable after debugging

디버깅이 끝났다면 보안을 위해 설정을 원래대로 돌려놓아야 합니다. 로그에는 전화번호나 메시지 본문 같은 민감한 정보가 포함될 수 있기 때문이에요.

1. 설정 파일 삭제: sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist
2. 설정 즉시 반영 (선택 사항): sudo log config --reload

설정이 막히거나 더 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요.

다음 단계

• 고급 디버깅 가이드
• CLI 명령어 참조