🦞 32. HEARTBEAT_OK만 반복될 때 바로 고치는 방법

heartbeat 자동 점검이 돌아가는데 사용자에게는 HEARTBEAT_OK만 반복해서 보이고, 실제 할 일은 실행되지 않는 경우가 있다. 이 문제는 대부분 (1) heartbeat 판정 조건, (2) 오늘 계획 파일 체크 로직, (3) 시작/완료 알림 순서 중 하나가 빠졌을 때 발생한다.

관련 개념은 OpenClaw 06: Cron Job과 OpenClaw 25: 크론 서브에이전트 분산운영을 같이 보면 이해가 빠르다.

먼저 핵심 원인부터 정리

HEARTBEAT_OK는 “진짜 아무 일도 없을 때”만 보내야 한다. 그런데 아래 중 하나라도 틀리면 실제로는 할 일이 있는데도 빈 응답처럼 보인다.

오늘 계획의 미완료 항목([ ])이 있는데 시간 비교를 건너뜀
## 오늘 계획 섹션이 없는데 자동 생성을 안 함
작업이 시작됐는데 시작 알림 없이 결과만 기록함

flowchart TD
A[Heartbeat 수신] --> B[오늘 memory 파일 읽기]
B --> C{오늘 계획 섹션 존재?}
C -- 아니오 --> D[기본 계획 생성]
C -- 예 --> E[미완료 항목/완료 항목 카운트]
D --> E
E --> F{현재 시각 지난 미완료 항목 있음?}
F -- 예 --> G[시작 알림 전송 → 작업 실행 → 완료 알림]
F -- 아니오 --> H[HEARTBEAT_OK]

칠판 치트시트 (30초 점검)

memory/YYYY-MM-DD.md에 오늘 계획이 있는지 확인

현재 시각보다 지난 [ ] 항목이 있는지 확인

있으면 HEARTBEAT_OK 대신 시작/완료 알림 + 실제 실행

없을 때만 HEARTBEAT_OK

복구 순서 (누가/무엇을/어떤 순서)

운영자(또우)가 아래 순서로 점검하면 된다.

오늘 메모 파일 확인

cat /home/tw2/.openclaw/workspace/memory/$(date +%F).md

오늘 계획 섹션 유무 확인

없으면 즉시 기본 3개 작업 템플릿 생성

시간 지난 미완료 항목이 있으면 즉시 실행

시작 알림 → 실제 작업 → 완료 알림 순서 고정

로그 반영

[ ]를 [x]로 바꾸고 실행 결과 한 줄 남기기

미니 사례 2개

사례 A) 오전엔 정상인데 오후부터 HEARTBEAT_OK만 오는 경우

원인: 오전 체크 때 만든 상태 캐시를 오후에도 재사용
해결: heartbeat마다 오늘 파일을 다시 읽고 현재 시각으로 재판정

사례 B) 실제 작업은 했는데 사용자 체감이 없는 경우

원인: 시작 알림 없이 파일만 수정
해결: 시작/완료 알림을 사용자 채널에 먼저/나중으로 분리 전송

재발 방지 팁

heartbeat 로직은 “판정(need action)“과 “응답(OK/알림)“을 분리해 설계
미완료가 0개이고 완료가 1개 이상이면 재생성 금지 규칙 유지
“아무 일 없음” 응답은 마지막 단계에서만 확정

다음에 읽을 글 (내부링크 10선)

한 줄 결론

HEARTBEAT_OK 반복 문제는 장애보다 판정 로직 누락인 경우가 많다.
오늘 계획 확인 → 시간 비교 → 알림 순서만 고정해도 대부분 즉시 해결된다.

※ 이 문서는 생성형 AI를 활용해 작성되었습니다.

일하는 ai

탐색기