Heartbeat no OpenClaw é o mecanismo que transforma um assistente de IA reativo em um agente proativo. Em vez de esperar você mandar uma mensagem, o agente acorda em intervalos definidos, verifica o que mudou, decide se existe algo útil a fazer e entrega um recibo quando há informação relevante. É a diferença entre “chatbot que responde” e “operador que acompanha a rotina”.

O erro comum é tratar heartbeat como sinônimo de notificação recorrente. Se o agente manda “está tudo bem” a cada cinco minutos, ele vira ruído. Um heartbeat bom trabalha em silêncio na maior parte do tempo. Ele só aparece quando encontra risco, oportunidade, bloqueio, decisão pendente ou uma entrega combinada, como um briefing matinal.

Este guia mostra como desenhar heartbeats úteis no OpenClaw: quando usar, como escrever o prompt, quais limites colocar e como evitar que a automação vire spam.

Quando usar heartbeat

Use heartbeat quando a tarefa depende de vigilância contínua ou de checagens frequentes. Bons exemplos:

  • conferir se canais como Telegram e WhatsApp continuam respondendo;
  • revisar agenda, emails e tarefas antes do expediente;
  • monitorar sites, formulários, jobs e integrações;
  • resumir mudanças em uma pasta, planilha, CRM ou fila de tickets;
  • lembrar decisões que ficaram pendentes;
  • consolidar notas recentes em memória ou base de conhecimento.

Não use heartbeat para tudo. Se a tarefa tem horário fixo e entrega previsível, um cron job do OpenClaw costuma ser melhor. Se a tarefa deve rodar só quando algo externo chama uma URL, use webhook. Heartbeat é ideal para uma pergunta periódica: “tem algo que eu preciso saber ou fazer agora?”.

A regra de ouro: silêncio também é resultado

Um agente proativo precisa ter permissão para não falar. Isso evita o pior padrão de automação: mensagens constantes que treinam o usuário a ignorar o bot.

Um prompt ruim seria:

A cada heartbeat, me mande um resumo do status.

Um prompt melhor:

A cada heartbeat, verifique agenda, tarefas vencidas, canais conectados e alertas críticos. Responda apenas se houver compromisso nos próximos 90 minutos, tarefa vencida de alta prioridade, canal desconectado ou decisão bloqueando trabalho. Se nada exigir atenção, fique em silêncio.

A segunda versão define gatilhos. O agente sabe o que procurar e quando interromper. Para rotinas pessoais, esse padrão combina com o guia de primeiro dia no OpenClaw e com pós-instalação, porque cria valor sem exigir integrações complexas.

Escreva o heartbeat como política operacional

Um bom HEARTBEAT.md ou prompt de heartbeat tem cinco blocos.

1. Fontes

Liste onde o agente pode olhar. Exemplo:

Fontes autorizadas: agenda, tarefas locais, últimas mensagens do canal atual, status do gateway, sites listados em SITES.md e notas em memory/YYYY-MM-DD.md.

Sem fontes claras, o agente tende a responder de forma genérica. Com fontes explícitas, ele verifica evidências.

2. Gatilhos

Defina o que merece resposta:

Responda apenas quando houver: falha técnica, prazo vencendo, decisão humana necessária, oportunidade de alto valor ou resumo diário programado.

Essa linha é o antispam do agente.

3. Limites

Diga o que ele não pode fazer sozinho:

Não envie mensagens externas, não publique conteúdo, não apague arquivos, não compre serviços e não altere produção sem aprovação explícita.

Esse bloco deve conversar com sua política de human-in-the-loop. Heartbeat pode preparar ação; ação sensível precisa de confirmação.

4. Formato de recibo

Quando o agente falar, ele deve ser específico:

Quando houver alerta, responda em até 6 linhas: problema, evidência, impacto, próxima ação recomendada e se precisa de aprovação.

“Algo deu errado” não ajuda. “Telegram desconectado desde 07:42; impacto: aprovações não chegam; próxima ação: reconectar canal” ajuda.

5. Persistência

Se a descoberta precisa sobreviver, mande registrar:

Registre aprendizados duráveis em memória ou wiki; registre trabalho concluído no sistema de atividades; não confie em memória mental da sessão.

Isso impede que um heartbeat encontre o mesmo problema várias vezes sem histórico.

Exemplo: heartbeat pessoal enxuto

Para um usuário solo, comece simples:

A cada heartbeat, verifique se há algo realmente acionável para mim. Prioridade: compromisso nos próximos 90 minutos, mensagem aguardando resposta há mais de 24h, tarefa vencida, falha em canal ou alerta de site. Se houver, responda com: item, evidência, urgência e próxima ação. Se não houver nada acionável, não responda. Nunca envie mensagem para terceiros sem aprovação.

Esse desenho funciona bem para quem usa OpenClaw como assistente pessoal no celular. O agente não tenta administrar sua vida inteira; ele reduz esquecimentos e chama atenção quando vale a pena.

Exemplo: heartbeat operacional para pequena empresa

Para uma operação comercial ou técnica, o heartbeat pode ser mais rígido:

A cada 15 minutos em horário comercial, confira: status do site principal, formulário de contato, fila de tickets urgentes, pagamentos com erro e mensagens de clientes sem resposta. Avise apenas se houver falha, SLA estourando, pagamento crítico ou cliente bloqueado. Inclua URL, horário, fonte e ação sugerida. Não responda clientes, não prometa prazo e não altere sistemas sem aprovação.

Esse padrão é útil para atendimento, vendas e suporte. Ele também complementa o checklist de produção para OpenClaw no WhatsApp e Telegram, porque não basta o bot estar configurado; alguém precisa notar quando ele fica silencioso.

Frequência: menos é mais

Intervalo curto demais gera custo, cansaço e falso senso de controle. Para a maioria dos usos:

  • 5 minutos: apenas para incidentes, canais críticos ou janelas curtas;
  • 15 a 30 minutos: bom para fila comercial, suporte e operações leves;
  • 1 a 4 horas: bom para pesquisa, revisão de tarefas e checagens de rotina;
  • 1 vez por dia: melhor para briefing, consolidação e auditoria.

Se o heartbeat depende de modelo caro, navegador ou APIs externas, aumente o intervalo e seja mais seletivo nos gatilhos. A página de custos de IA no OpenClaw ajuda a pensar nisso.

Como testar sem criar barulho

Antes de ligar em produção, rode por alguns ciclos em modo observação. Peça para o agente salvar um log local ou responder apenas no canal de teste. Depois revise:

  1. quantas vezes ele falou;
  2. quantas mensagens foram realmente úteis;
  3. quantas poderiam virar silêncio;
  4. quais fontes faltaram;
  5. quais ações exigiram aprovação.

Ajuste o prompt até a taxa de ruído ficar baixa. Um bom heartbeat parece discreto: você não percebe quando tudo vai bem, mas confia que será chamado quando algo sai do esperado.

Próximo passo

Escolha uma checagem que hoje depende da sua memória: agenda, canal conectado, formulário, site no ar ou tarefa vencida. Escreva fontes, gatilhos, limites e recibo. Comece com leitura e alerta. Só depois adicione ações com aprovação.

O melhor agente proativo não é o que fala mais. É o que protege sua atenção e aparece no momento certo.