하트비트 (Heartbeat)는 심장 박동 같은 것 — AI 에이전트 (Agent)가 '나 아직 살아있어요'라고 일정 간격으로 보내는 신호로, 에이전트가 멈추거나 죽었는지 시스템이 알아채는 방법이다.
사람도 맥박이 멈추면 의식을 잃은 걸 알 수 있듯, 소프트웨어 세계에서도 프로그램이 정상 작동 중인지 확인하는 방법이 필요하다. 하트비트 (Heartbeat)는 에이전트 (Agent)나 서버 (Server)가 정해진 시간 간격(예: 30초마다)으로 '나 정상이에요'라는 신호를 게이트웨이 (Gateway)나 관리 시스템에 보내는 동작이다. 신호가 일정 횟수 이상 오지 않으면 시스템은 해당 에이전트가 멈춘 것으로 판단하고 재시작하거나 알림을 보낸다.
1인 비즈니스(1인 사이트 운영)에서 하트비트는 백그라운드에서 조용히 일하는 자동화 에이전트를 관리할 때 핵심 역할을 한다. 예를 들어 OpenClaw 의 게이트웨이 (Gateway)가 하트비트를 통해 연결된 에이전트들의 생존 여부를 모니터링하고, 채널 (Channel, Discord·Slack·Telegram 등)로 메시지가 왔는데 에이전트가 응답하지 않는다면 하트비트 신호 부재를 통해 문제를 감지할 수 있다. 혼자 운영하는 사이트에서 에이전트가 몰래 죽어 있어도 알아채지 못한다면 큰 문제가 생길 수 있기 때문에, 하트비트는 에이전트 신뢰성의 보험 같은 장치다.
초보자가 흔히 혼동하는 점은 하트비트를 '에이전트가 실제로 일하는 신호'로 착각하는 것이다. 하트비트는 '살아있음'을 알리는 신호일 뿐, 작업을 열심히 하고 있다는 의미가 아니다. 에이전트가 멈추지 않고 대기 중인 상태도 정상 하트비트로 표시된다. 실제 작업 결과는 별도의 로그 (Log)나 응답으로 확인해야 한다.
AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.