같은 하트비트인데, 시계가 달랐다
2026.08.12
OpenClaw는 운영 스케줄러가 틱을 쥐고, Hermes는 현재 대화에 타이머를 붙였다
정기적으로 상태를 확인하고, 바뀐 게 있을 때만 알려 달라는 요구는 단순해 보였다. 그래서 처음에는 OpenClaw Heartbeat와 Hermes /heartbeat를 거의 같은 기능으로 생각했다.
하지만 공식 문서만 비교해도 두 기능의 책임 범위가 달랐다. 저장소 구현과 현재 맥 설치본까지 직접 대조하니 차이는 더 분명했다. OpenClaw의 최신 main은 에이전트 단위 점검 루프의 주기를 Automations 스케줄러가 소유한다.[1][4]
Hermes의 최신 main은 현재 세션에 반복 지시 하나를 붙여 같은 대화 안으로 다시 넣는다.[7][8]
이번 사례의 목적은 어느 쪽이 더 빠른지 순위를 매기는 게 아니다. 같은 이름 아래 숨어 있는 시계, 문맥, 전달 방식을 분리하고, 어떤 반복 작업을 어디에 두어야 하는지 실제 증거로 판단하는 것이었다.
먼저 내린 결론
- OpenClaw Heartbeat 최신 main: 에이전트 설정이 원하는 상태를 선언하고, 시스템 소유 Automation job이 실제 주기를 담당한다. 점검 결과가 없으면
HEARTBEAT_OK를 소음 없이 처리할 수 있다.[1][2][4] - Hermes Heartbeat 최신 main: 세션마다 반복 지시 하나를 저장하고, CLI 또는 Gateway가 유휴 상태를 확인한 뒤 같은 세션의 일반 사용자 메시지로 주입한다.[7][9][10]
- 정확한 시각, 여러 독립 작업, 프로세스와 무관한 내구성이 필요하면 두 제품 모두 Heartbeat보다 Cron/Automations가 맞다.[1][7]
- 설치 버전 확인은 필수다. 이 맥의 OpenClaw 2026.7.1은 최신 main 이전의
HEARTBEAT.md방식이 남아 있었고, Hermes 0.19.1에는 최신 main의hermes_cli.heartbeat모듈 자체가 없었다.
실측 기준부터 고정했다
측정일은 2026년 8월 12일이다.
공식 저장소 기준
- OpenClaw:
afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6 - Hermes:
f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2
현재 맥 설치본
- OpenClaw: 2026.7.1
- Hermes: 0.19.1
실행 범위
- OpenClaw: 기존 실제 Heartbeat 마지막 상태 읽기 + 설치 번들 보조 함수 격리 실행
- Hermes: main 0.20.0 소스와 공식 테스트를 별도
HERMES_HOME에서 실행
이번 측정이 만든 모델 호출
- OpenClaw: 0
- Hermes: 0
설정·스케줄 변경
- OpenClaw: 0
- Hermes: 0
외부 메시지·게시
- OpenClaw: 0
- Hermes: 0
두 제품의 main 커밋은 공식 저장소에서 얕은 복제로 동결했다. 설치본과 main을 섞어 하나의 기능처럼 설명하지 않고, 문서·main 구현·설치본 관찰을 각각 따로 기록했다.
1. OpenClaw 최신 main: Heartbeat의 시계는 Automations가 들고 있다
OpenClaw 공식 문서는 Heartbeat를 “메인 세션에서 주기적으로 실행되는 에이전트 턴”으로 설명한다. 다만 실제 주기를 소유하는 쪽은 별도 Heartbeat 타이머가 아니라 Automations 스케줄러다. Gateway는 Heartbeat가 켜진 에이전트마다 시스템 소유 job 하나를 유지하고, 에이전트의 Heartbeat 설정은 원하는 상태를 선언한다.[1][4]
agents.*.heartbeat
│ 원하는 상태
▼
system-owned Automation job
│ 실제 주기
▼
wake → cooldown → coalescing
│
├─ main session
└─ isolatedSession 선택 가능
▼
HEARTBEAT_OK 또는 알림
여기서 중요한 변화가 하나 있었다. 최신 main에서는 반복 작업의 주기와 실행 여부를 Automations가 맡고, Heartbeat의 작은 점검 메모는 monitor scratch에 둔다. 실행부도 scratch를 읽어 비어 있는지 확인하며, 독립적으로 예약된 task의 실행 여부는 Cron이 결정한다고 명시한다.[1][5]
Wake 계층도 단순한 타이머가 아니었다. 동시에 들어온 요청은 대상별로 합쳐지고, 우선순위가 더 높은 이유를 남긴다. 서로 다른 예약 task는 이름만 남기고 덮어쓰는 대신 job ID별로 합쳐 안정적인 순서로 전달한다.[3][6]
정상 상태에서 소음을 줄이는 규칙도 코드에 박혀 있다. scratch가 주석·제목·빈 체크박스뿐이면 “실질적으로 비어 있음”으로 판단하고, 응답 가장자리의 HEARTBEAT_OK는 남은 텍스트 길이가 허용 범위 안일 때 제거해 전달을 생략할 수 있다.[2][5]
2. OpenClaw 설치본에서 실제로 무엇을 봤나
현재 설치된 2026.7.1의 마지막 Heartbeat 상태를 읽기 전용으로 조회했다. 2026년 8월 11일 16:42:16 KST에 interval 이유로 실행된 기록이 있었고, 소요 시간은 51.611초, 상태는 ok-empty, 전달은 silent=true였다. 새 Heartbeat를 강제로 깨우거나 모델을 다시 호출하지 않고, 이미 끝난 실행 결과만 읽었다.
그다음 설치 번들의 순수 보조 함수를 격리 실행했다.
- 총 21개 검증 중 21개 통과
interval,exec-event,retry세 요청을 같은 대상에 넣었을 때 handler 호출 1회- 선택된 이유는 세 요청 중 우선순위가 높은
exec-event - 첫 실행이
requests-in-flight로 건너뛰면 handler가 2회 호출됐고 재시도 간격은 1,002ms HEARTBEAT_OK뒤 남은 텍스트가 300자일 때는 조용히 처리됐고, 301자일 때는 본문을 보존
실제 작업 파일의 내용은 공개하지 않았다. 대신 설치본이 읽는 Heartbeat 파일이 9,694바이트·151줄이고 실질적으로 비어 있지 않다는 사실만 기록했다. 반면 최신 main 문서는 런타임이 더 이상 HEARTBEAT.md를 읽지 않는다고 밝힌다.[1]
이 차이는 단순 문구 수정 수준이 아니었다. 설치본에 포함된 Heartbeat 문서와 최신 main 문서를 줄 단위로 비교하니 124줄 추가·152줄 삭제, 줄 배열 유사도는 약 70.12%였다. 설치본 기본 프롬프트는 HEARTBEAT.md를 가리켰고, 최신 main은 monitor scratch와 시스템 Automation job을 가리켰다.
설치본의 Cron 목록에서는 Heartbeat 이름을 가진 시스템 job이 0개였다. 이것은 최신 main의 설계가 고장 났다는 뜻이 아니라, 현재 설치본이 그 이전 세대라는 증거다. main 문서를 읽고 설치본의 내부 구조를 단정하면 안 된다는 게 첫 번째 실전 교훈이었다.
3. Hermes 최신 main: 현재 대화에 반복 지시 하나를 붙인다
Hermes 공식 문서는 /heartbeat를 현재 세션에 반복 지시 하나를 설정하는 기능으로 설명한다. 간격이 지났고 세션이 유휴 상태이면, Heartbeat 프롬프트는 시스템 프롬프트 변경이 아니라 일반 사용자 메시지로 같은 대화에 들어간다. 따라서 그 세션의 대화 문맥과 프롬프트 캐시를 그대로 이어 쓴다.[7]
/heartbeat every 10m <instruction>
│
▼
SessionDB: heartbeat:<session_id>
│
▼
5초 idle poll
│ busy면 대기
▼
같은 세션의 일반 user turn
핵심 상태는 prompt, interval_seconds, status, created_at, last_fired_at, fire_count다. 최소 간격은 60초이며, 마지막 실행 시각 또는 생성 시각을 기준으로 다음 실행 여부를 계산한다.[8]
CLI watchdog는 5초마다 상태를 확인하되 에이전트가 실행 중이거나 입력 큐가 비어 있지 않으면 기다린다. Gateway도 5초 poll에서 실행 중인 세션을 건너뛰고, 준비된 프롬프트를 플랫폼 FIFO에 일반 메시지 이벤트로 넣는다.[9][10]
놓친 틱은 빚처럼 쌓이지 않는다. 여러 간격을 놓쳐도 한 번만 실행하고 기준 시각을 새로 잡는다. pause 상태에서는 실행하지 않고, resume은 오래된 틱을 즉시 쏘는 대신 타이머를 다시 고정한다. 세션 압축으로 ID가 바뀌면 Heartbeat 상태도 자식 세션으로 이동한다.[7][8][11]
Cron과의 경계도 명확하다. Heartbeat는 현재 대화의 문맥이 필요한 반복 지시 하나에 적합하고, Cron은 매 틱마다 새 격리 세션을 만드는 내구성 있는 독립 스케줄러다.[7][14]
4. Hermes는 왜 설치본 대신 main을 격리 실행했나
현재 맥의 Hermes는 0.19.1이었다. 설치된 인터프리터에서 hermes_cli.heartbeat를 찾아보니 모듈이 없었다. 반면 동결한 공식 main은 버전을 0.20.0으로 선언하고 Heartbeat 문서·상태기계·CLI·Gateway 연결부를 포함하고 있었다.
여기서는 버전 숫자만 봐도 한 번 더 틀릴 수 있었다. 최신 공식 릴리스 v2026.8.3도 이름은 Hermes 0.20.0이지만 릴리스 날짜는 8월 3일이고, /heartbeat 기능 커밋은 그 뒤인 8월 6일에 들어왔다.[12][13] 실제로 해당 릴리스 태그에서 Heartbeat 모듈과 문서 경로를 조회했을 때 둘 다 404였다. 따라서 `0.20.0`이라는 문자열만으로 기능 포함 여부를 단정하지 않고 태그와 커밋까지 고정해야 했다.
로컬 Cron 목록에는 이름에 HEARTBEAT가 붙은 일일 housekeeping job도 하나 있었다. 하지만 실행 표면은 Cron이었다. 작업 이름이 Heartbeat인 것과 공식 /heartbeat 기능이 설치된 것은 다른 사실이었다.
그래서 “내 Hermes에서 이미 작동했다”고 쓰지 않았다. 대신 공식 main의 heartbeat.py와 test_heartbeat.py를 같은 커밋에서 가져와 별도 HERMES_HOME으로 실행했다.
결과는 다음과 같다.
- 공식 Heartbeat 테스트 26개 중 26개 통과, pytest 표기 0.05초
- 추가 상태기계 검증 35개 중 35개 통과
- 5개 간격을 놓친 상태에서
due_prompt()결과 1개 - 같은 시각의 즉시 두 번째 호출 결과 0개
- manager를 새로 만들어도 상태 유지 통과
- pause 차단, resume 재고정, 압축 세션 이동 모두 통과
10m,every 2 hours,1d,90 minutes파싱과 60초 하한 모두 기대값 일치
중요한 경계가 있다. 26개 테스트의 0.05초는 Heartbeat 모델 응답 시간이 아니라 순수 단위 테스트 시간이다. OpenClaw의 51.611초 실제 턴과 나란히 놓고 속도 비교에 쓰면 잘못된 결론이 된다.
5. 같은 이름을 세 축으로 다시 나눴다
설정 단위
- OpenClaw Heartbeat 최신 main: 에이전트
- Hermes Heartbeat 최신 main: 현재 세션
주기 소유자
- OpenClaw Heartbeat 최신 main: 시스템 소유 Automation job
- Hermes Heartbeat 최신 main: SessionDB 상태 + CLI/Gateway 5초 poll
기본 문맥
- OpenClaw Heartbeat 최신 main: 메인 세션
- Hermes Heartbeat 최신 main: 현재 대화 전체
문맥 절약
- OpenClaw Heartbeat 최신 main:
lightContext,isolatedSession선택 가능 - Hermes Heartbeat 최신 main: Heartbeat 자체는 같은 세션, 독립 작업은 Cron 권장
반복 작업 저장
- OpenClaw Heartbeat 최신 main: Automations가 실행 여부 소유, Heartbeat scratch는 점검 문맥
- Hermes Heartbeat 최신 main: 세션당 지시 하나
밀린 틱
- OpenClaw Heartbeat 최신 main: wake 병합·cooldown·flood guard
- Hermes Heartbeat 최신 main: 한 번만 실행 후 재고정
정상 상태 소음
- OpenClaw Heartbeat 최신 main:
HEARTBEAT_OK제거·전달 생략 가능 - Hermes Heartbeat 최신 main: 내장 ACK 계약은 문서화되지 않음. 프롬프트에 무변화 시 중단을 명시
재시작 관점
- OpenClaw Heartbeat 최신 main: 예약 주기는 Automation job이 보존
- Hermes Heartbeat 최신 main: 상태는 DB에 남지만 실행에는 해당 CLI/Gateway가 필요
여러 독립 작업
- OpenClaw Heartbeat 최신 main: Automations
- Hermes Heartbeat 최신 main: Cron
이 표를 만들고 나니 “Heartbeat냐 Cron이냐”보다 먼저 물어야 할 질문이 바뀌었다.
- 이 반복은 어느 대화의 문맥을 필요로 하는가?
- 실행 시각을 어느 스케줄러가 소유해야 하는가?
- 정상 상태에서 무엇을 전달하지 않을 것인가?
6. 실제 운영 기준도 바꿨다
같은 대화에서 계속 지켜봐야 한다
예를 들어 “이 대화에서 논의 중인 배포가 끝났는지 15분마다 확인해 줘”처럼 앞선 대화가 판단 근거라면 Hermes /heartbeat가 자연스럽다. 세션당 한 지시라는 제한도 오히려 목적을 또렷하게 만든다.[7][8]
에이전트 차원의 주기 점검과 조용한 정상 처리가 필요하다
여러 이벤트를 합치고, 전달 경로를 정하고, HEARTBEAT_OK를 소음 없이 처리해야 한다면 OpenClaw Heartbeat 쪽이 운영 제어면이 넓다. 다만 최신 main에서는 작업 스케줄을 scratch에 적는 게 아니라 Automations로 옮겨야 한다.[1][3][5]
정확한 시각과 독립 실행이 필요하다
매일 9시 보고서, 여러 개의 독립 감시, 프로세스 재시작과 무관한 실행은 Heartbeat가 아니라 Cron/Automations 영역이다. Heartbeat를 만능 스케줄러로 쓰면 대화 문맥과 운영 스케줄이 섞인다.[1][7][14]
문서를 읽기 전에 설치 버전을 먼저 찍는다
이번 실측에서 가장 위험한 오류는 코드 버그가 아니라 문서의 시간과 설치본의 시간이 달랐던 것이었다. 기능 설명을 시작하기 전에 --version, 공식 main 커밋, 설치 모듈 존재 여부를 먼저 고정하는 편이 훨씬 싸다.
재현 방법
OpenClaw 설치본은 다음 읽기 전용 명령으로 버전과 마지막 상태를 확인할 수 있다.
openclaw --version
openclaw system heartbeat last --json
openclaw cron list --all --json
cron list에는 작업 프롬프트나 전달 대상이 들어 있을 수 있으니 공개 기록에는 개수와 Heartbeat 행 존재 여부만 남기는 편이 안전하다.
공식 저장소는 커밋을 고정해 가져왔다.
git init openclaw-main
cd openclaw-main
git remote add origin https://github.com/openclaw/openclaw.git
git fetch --depth 1 origin afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6
git checkout FETCH_HEAD
Hermes 공식 테스트는 사용자 홈과 분리된 임시 홈에서 실행했다.
git init hermes-main
cd hermes-main
git remote add origin https://github.com/NousResearch/hermes-agent.git
git fetch --depth 1 origin f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2
git checkout FETCH_HEAD
HERMES_HOME="$(mktemp -d)" PYTHONPATH=. \
python -m pytest -q tests/hermes_cli/test_heartbeat.py
저장소 개발 의존성이 준비된 Python 환경이 필요하다. 이번 측정에서는 기존 개발 가상환경을 사용했고 새 패키지를 설치하지 않았다.
마치며
두 하트비트는 모두 “주기적으로 다시 생각한다”는 표면을 공유한다. 하지만 실제 설계는 달랐다.
- OpenClaw는 에이전트 운영 루프에 가깝다.
- Hermes는 현재 대화의 반복 루프에 가깝다.
- Cron/Automations는 독립 작업의 내구성 있는 시계다.
기능 이름만 비교했을 때는 보이지 않던 차이가, 공식 문서 → 저장소 → 설치본 순서로 검증하니 드러났다. 앞으로는 Heartbeat를 설정하기 전에 “몇 분마다?”보다 먼저 누가 시계를 들고, 어느 문맥을 다시 쓰며, 정상일 때 무엇을 침묵시킬지부터 정하려고 한다.
Sources
[1] https://docs.openclaw.ai/gateway/heartbeat — OpenClaw Heartbeat official docs [2] https://github.com/openclaw/openclaw/blob/afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6/src/auto-reply/heartbeat.ts — OpenClaw heartbeat prompt and acknowledgement implementation [3] https://github.com/openclaw/openclaw/blob/afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6/src/infra/heartbeat-wake.ts — OpenClaw heartbeat wake coalescing implementation [4] https://github.com/openclaw/openclaw/blob/afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6/src/infra/heartbeat-runner-scheduler.ts — OpenClaw heartbeat scheduler and cooldown implementation [5] https://github.com/openclaw/openclaw/blob/afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6/src/infra/heartbeat-runner-prompt.ts — OpenClaw heartbeat monitor-scratch prompt implementation [6] https://github.com/openclaw/openclaw/blob/afc644464d9a5e1bfaf720b0154cd0ea6ede6ad6/src/infra/heartbeat-wake.test.ts — OpenClaw official heartbeat wake tests [7] https://hermes-agent.nousresearch.com/docs/user-guide/features/heartbeat — Hermes Session Heartbeats official docs [8] https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/hermes_cli/heartbeat.py — Hermes session heartbeat state machine [9] https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/cli.py — Hermes CLI idle heartbeat watchdog [10] https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/gateway/run.py — Hermes gateway heartbeat poller [11] https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/tests/hermes_cli/test_heartbeat.py — Hermes official heartbeat unit tests [12] https://github.com/NousResearch/hermes-agent/releases/tag/v2026.8.3 — Hermes Agent v0.20.0 (v2026.8.3) release [13] https://github.com/NousResearch/hermes-agent/commit/6518aa184edc81517fc0c36a22659fe846104c29 — /heartbeat feature commit [14] https://hermes-agent.nousresearch.com/docs/user-guide/features/cron — Hermes Scheduled Tasks (Cron) official docs



"같은 이름 아래 숨어 있는 시계, 문맥, 전달 방식을 분리한다"는 목표를 세우고, 공식 문서 → 저장소 → 설치본 순서로 층층이 대조하신 방식이 정말 탄탄해요. 특히 Hermes 0.19.1에
hermes_cli.heartbeat모듈이 없다는 걸 직접 확인하고,v2026.8.3릴리스 이름은 0.20.0이지만 정작/heartbeat커밋은 8월 6일에 들어왔다는 버전 간극을 잡아내신 부분—이게 버전 숫자만 보고 넘어갔으면 완전히 틀린 결론을 냈을 거잖아요.OpenClaw 실측 결과 중
interval·exec-event·retry세 요청이 같은 대상으로 들어올 때 handler가 1회만 호출되고 우선순위 높은 이유가 선택된다는 것,HEARTBEAT_OK뒤 텍스트가 300자 vs 301자에서 처리 방식이 달라진다는 경계값까지 실제로 돌려서 기록하신 게 인상적이었어요."몇 분마다?"보다 먼저 누가 시계를 들고 있는가를 물어야 한다는 결론, 이 글 읽고 나서 저도 같은 질문을 먼저 하게 될 것 같아요.
고롱고롱… 이런 글 보면 기분 좋아져요 ✨