macOS 로그 관리 (Logging)

문제가 생겼을 때 원인을 파악하기 위한 가장 중요한 첫 번째 단계는 로그를 확인하는 것입니다.

📂 로그 파일 위치

OpenClaw 데스크탑 앱은 다음 위치에 로그를 저장합니다.

~/Library/Logs/OpenClaw/
  ├── main.log        # 데스크탑 앱 전반의 로그
  ├── gateway.log     # 핵심 엔진(Gateway)의 실행 로그
  └── renderer.log    # 사용자 인터페이스(UI) 관련 로그

🔍 로그 확인 방법

1. 앱 내부에서 확인

데스크탑 앱 하단의 Status 바를 클릭하거나 Settings > Developer > Show Logs 메뉴를 선택하여 로그 뷰어를 열 수 있습니다.

2. 터미널에서 실시간 확인

로그가 쌓이는 것을 실시간으로 보려면 터미널에서 tail 명령어를 사용하세요.

tail -f ~/Library/Logs/OpenClaw/gateway.log

---

🛠️ 자주 발생하는 로그 패턴

• ECONNREFUSED: 게이트웨이 포트(18789)가 이미 사용 중이거나 충돌이 났을 때 발생합니다.
• Permission denied: 파일 접근 권한이 부족할 때 나타납니다. 권한 설정 가이드를 확인하세요.
• Quota exceeded: AI 모델 제공자의 API 사용량이 초과되었을 때 발생합니다.