채팅과 도구가 돌아간 다음 단계는 N분마다 요약·큐 확인·가벼운 헬스 포스트 같은 예측 가능한 리듬입니다. 2026년 OpenClaw에서는 이것이 Heartbeat와 HEARTBEAT.md에 가깝습니다. 본 글은 무응답 트러블슈팅 글과 역할이 다름을 분명히 합니다: 그쪽은 doctor와 로그로 조용히 실패할 때의 순서, 여기는 능동적 간격 자동화의 경계·리스크·최소 스켈레톤, launchd와의 상주 연동, 렌탈 Mac의 절전·환경 차이, VNC로 Gateway UI를 대조하는 체크입니다. 오류 10가지는 별도 글, TLS 공개는 Gateway 역프록시로.
Heartbeat에 맞는 사용자
설치와 첫 대화가 끝났고 저빈도 멱등 확인(요약·깊이·신호)을 자동화하려는 사람에게 적합합니다. 맞지 않는 예: 무제한 크롤링, 검토 없는 프로덕션 쓰기, 고가 모델의 고빈도 폴링. 클라우드 Mac에서는 절전, GUI 승인, localhost 바인딩을 함께 고려하고 VNC로 한 번에 가시화합니다.
아픔: 경계·비용·과신
- 범위 팽창: Heartbeat는 주기적 에이전트 턴이지 OS cron 전체 대체가 아닙니다.
- thinking과 무음: 무응답 글과 같이 보이는 텍스트 없이 비용만 사라질 수 있습니다.
- 환경 차이: 대화형 셸의 export는
launchd자식 프로세스에 자동 상속되지 않습니다. - 절전: 노드가 자면 Gateway와 간격도 멈춥니다.
- 관측성: “마지막 성공 tick”이 없으면 설정 문제를 모델 탓으로 돌리기 쉽습니다.
판단 표
| 시나리오 | 기반 | Heartbeat 역할 | 주요 리스크 |
|---|---|---|---|
| 개인 다이제스트 | 단일 Gateway | 저빈도 요약 | 비용·채널 노이즈 |
| 소팀 모니터링 | launchd+로그 | 정기 헬스 | 권한 대화상자(VNC 권장) |
| 다중 프로젝트 | 디렉터리/포트 분리 | 인스턴스별 파일 | 비밀 혼선 |
| 외부 Webhook | 역프록시+TLS | 속도 제한 필수 | 노출면 |
키 이름은 릴리스마다 바뀔 수 있으므로 openclaw doctor와 v2026.4.5 마이그레이션 글과 대조하세요.
7단계 도입
# HEARTBEAT.md (예시 — 실제 키는 공식 문서로 교체) interval_minutes: 30 channel: <channel-id> on_tick: - summarize_inbox_depth fail_open: false
버전과 canonical 루트 고정
openclaw --version / doctor 기록.
처음엔 읽기 전용
프로덕션 변경은 나중에.
모델 라우트 분리
순회는 저가, 사람 트리거는 고성능.
실패 가시화
heartbeat_failed 등 짧은 이유를 같은 채널로.
launchd로 Gateway 감독
launchd 체크리스트를 따릅니다.
VNC로 콘솔 대조
bind와 브라우저 도달성 확인.
주간 초소형 운영 로그
시각·간격·아웃바운드 성공 여부·설정 버전.
인용 가능한 사실
관련 글
무응답 트러블슈팅, launchd 안정 운영, Gateway 역프록시, 자주 보는 오류 10가지.
VNC 검증과 FAQ
- 로컬 브라우저에서 컨트롤 URL이 열리는지
- 프라이버시/키체인 미처리 대화상자가 없는지
- 전원·잠금 설정이 제공사 규정과 맞는지
- 다중 인스턴스의 포트와 디렉터리가 일치하는지
FAQ는 head의 JSON-LD를 참조하세요.
요약
Windows나 범용 Linux만으로는 macOS 특유의 승인과 GUI 검증이 빠지기 쉽습니다. 실제 macOS 데스크톱에서 OpenClaw를 돌리고 VNC로 대조하면 Heartbeat가 블랙박스가 되기 어렵습니다. 단기 검증에 하드웨어를 사지 않으려면 VNCMac의 VNC 지원 Mac 렌탈과 본 사이트의 launchd·무응답·Gateway 글 조합이 시행착오 시간을 줄이기 쉽습니다.