macOS에서 채널 상태 실시간으로 확인하기

백엔드 서비스나 API 연결이 정상적으로 작동하고 있는지 매번 터미널을 열어 확인하는 건 꽤나 번거로운 일이에요. 분명 잘 돌아가고 있다고 생각했는데, 정작 중요한 순간에 연결이 끊겨 있어 당황했던 경험이 다들 한 번쯤은 있을 겁니다. 일일이 로그를 뒤지지 않고도 현재 상태를 한눈에 파악할 수 있는 직관적인 방법이 필요하죠.

필요한 것

• macOS 메뉴 바 앱
• openclaw CLI

빠른 시작

메뉴 바 아이콘과 설정 창을 통해 5분 안에 상태 확인 환경을 구성할 수 있습니다.

1. 메뉴 바 상태 확인: 아이콘의 색상을 통해 Baileys의 상태를 즉시 파악하세요.
   • 초록색: 연결 완료 및 최근 소켓 오픈 성공.
   • 주황색: 연결 중이거나 재시도 중인 상태.
   • 빨간색: 로그아웃되었거나 probe 실패.
   • 하단 라인에서 “linked · auth 12m” 메시지나 구체적인 실패 원인을 볼 수 있습니다.
2. 온디맨드 체크: 메뉴에서 “Run Health Check”를 클릭해 즉시 상태 확인을 트리거하세요.
3. 상세 설정 확인: General 탭의 Health 카드에서 인증 수명, session-store 경로 및 개수, 마지막 에러 코드를 확인하세요.
4. 채널 제어: Channels 탭으로 이동하면 WhatsApp 및 Telegram의 로그인 QR 확인, 로그아웃, probe 실행, 마지막 연결 끊김 원인을 관리할 수 있습니다.

앱은 ShellExecutor를 통해 약 60초마다 openclaw health --json을 실행하며, 메시지를 보내지 않고도 상태를 보고합니다. UI 로딩 시에는 캐시된 스냅샷을 사용해 끊김 없이 정보를 보여줍니다.

문제 해결

상태 표시가 예상과 다르거나 더 자세한 디버깅이 필요하다면 CLI를 활용해 보세요.

• CLI 상태 확인: 터미널에서 다음 명령어를 사용해 상세 상태를 조회할 수 있습니다.

  openclaw status
  openclaw status --deep
  openclaw health --json

• 로그 추적: 연결 이슈가 의심된다면 다음 경로의 로그 파일을 확인해 web-heartbeat나 web-reconnect 이벤트를 추적해 보세요.

  tail -f /tmp/openclaw/openclaw-*.log

더 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요.

다음 단계

• Gateway health