Health checks (macOS)
기준일: 2026-07-26
공식 기준: Health checks (macOS)
Health checks (macOS) 문서는 OpenClaw 공식 문서(platforms/mac/health)를 한국어로 정리한 가이드입니다. How the macOS app reports gateway/channel health states 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
How the macOS app reports gateway/channel health states
한국어 가이드 범위: platforms/mac/health 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- Health checks on macOS
- Menu bar
- Settings
- How the probe works
- When in doubt
- 관련 문서
상세 내용
Health checks on macOS
How to read the linked-channel health state from the menu bar app.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Menu bar
The secondary line reads "linked · auth 12m" or shows the failure reason. "Run Health Check Now" in the menu triggers an on-demand probe.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- Green: linked + probe healthy.
- Orange: linked but a channel probe reports degraded/not connected.
- Red: not linked yet.
Settings
auth age), and an optional failure detail line, with Retry now and
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- General tab shows a Health card: status dot, summary line (link state +
- Channels tab surfaces per-channel status and controls (login QR,
How the probe works
The app calls the Gateway's health RPC over its existing WebSocket connection (not a CLI shell-out) every ~60s and on demand. The RPC loads creds and reports status without sending messages. The app caches the last good snapshot and the last error separately so the UI loads instantly and does not flicker while offline.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
When in doubt
Use the CLI flow in Gateway health (openclaw status, openclaw status --deep, openclaw health --json) and run openclaw logs --follow, filtering for web-heartbeat / web-reconnect.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
관련 문서
주요 항목:
- Gateway health
- macOS app
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/platforms/mac/health - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
관련 링크
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.