Health Checks (CLI)

추측하지 않고 channel connectivity를 확인하기 위한 짧은 가이드입니다.

Quick checks

openclaw status — gateway reachability/mode, update hint, linked channel auth age, session, recent activity를 로컬에서 빠르게 요약합니다.
openclaw status --all — 전체 로컬 진단을 읽기 전용으로 출력합니다. color가 유지되고 디버깅용으로 붙여 넣기에도 안전합니다.
openclaw status --deep — 실행 중인 Gateway도 함께 probe합니다. 지원되는 경우 channel별 probe까지 수행합니다.
openclaw health --json — 실행 중인 Gateway에 전체 health snapshot을 요청합니다. WebSocket 전용이며 CLI가 Baileys socket에 직접 연결하지는 않습니다.
WhatsApp/WebChat에 /status를 단독 메시지로 보내면 agent를 호출하지 않고 status reply를 받을 수 있습니다.
log는 /tmp/openclaw/openclaw-*.log를 tail하면서 web-heartbeat, web-reconnect, web-auto-reply, web-inbound를 보면 됩니다.

disk 위 credential 확인: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime이 최근이어야 함)
session store 확인: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (config에서 경로 override 가능). session 수와 최근 recipient는 status에도 표시됩니다.
relink 흐름: log에 status code 409–515 또는 loggedOut이 보이면 openclaw channels logout && openclaw channels login --verbose로 다시 연결합니다. 참고로 QR login flow는 pairing 뒤 status 515가 나오면 자동으로 1회 재시작합니다.

logged out 또는 status 409–515 -> openclaw channels logout 후 openclaw channels login으로 relink
Gateway unreachable -> openclaw gateway --port 18789로 시작(포트가 바쁘면 --force)
inbound message가 없음 -> 연결된 phone이 online인지, sender가 channels.whatsapp.allowFrom에 허용되어 있는지 확인. group chat이면 channels.whatsapp.groups와 agents.list[].groupChat.mentionPatterns가 맞는지도 확인

openclaw health --json은 실행 중인 Gateway에 health snapshot을 요청합니다. CLI가 channel socket에 직접 붙는 방식은 아닙니다. 보고 항목:

동작 메모: