Skip to main content
O OpenClaw executa trabalhos em segundo plano por meio de tarefas, trabalhos agendados, compromissos inferidos, hooks de eventos e instruções permanentes. Use esta página para escolher o mecanismo adequado.

​
Guia rápido de decisão

​
Tarefas Agendadas (Cron) versus Heartbeat

Use Tarefas Agendadas (Cron) quando precisar de horários precisos ou execução isolada. Use Heartbeat quando o trabalho se beneficiar do contexto completo da sessão e um horário aproximado for suficiente.

​
Conceitos principais

​
Tarefas agendadas (cron)

Cron é o agendador integrado do Gateway para horários precisos. Ele mantém os trabalhos, ativa o agente no momento certo e pode entregar a saída a um canal de conversa ou endpoint de webhook. Oferece suporte a lembretes de execução única, expressões recorrentes e acionadores de webhook de entrada. Consulte Tarefas Agendadas.

​
Tarefas

O registro de tarefas em segundo plano acompanha todo trabalho desvinculado: execuções de ACP, inicializações de subagentes, execuções cron isoladas e operações da CLI. Tarefas são registros, não agendadores. Use openclaw tasks list e openclaw tasks audit para inspecioná-las. Consulte Tarefas em Segundo Plano.

​
Compromissos inferidos

Compromissos são memórias de acompanhamento opcionais e de curta duração. O OpenClaw os infere de conversas normais, limita-os ao mesmo agente e canal e entrega os contatos de acompanhamento no momento devido por meio do Heartbeat. Lembretes exatos solicitados pelo usuário ainda pertencem ao cron. Consulte Compromissos Inferidos.

​
Fluxo de Tarefas

O Fluxo de Tarefas é a camada de orquestração de fluxos acima das tarefas em segundo plano. Ele gerencia fluxos duráveis de várias etapas com modos de sincronização gerenciada e espelhada, acompanhamento de revisões e openclaw tasks flow list|show|cancel para inspeção. Consulte Fluxo de Tarefas.

​
Ordens permanentes

As ordens permanentes concedem ao agente autoridade operacional permanente para programas definidos. Elas ficam em arquivos do espaço de trabalho (normalmente AGENTS.md) e são injetadas em todas as sessões. Combine-as com cron para aplicação baseada em tempo. Consulte Ordens Permanentes.

​
Hooks

Hooks internos são scripts orientados a eventos acionados por eventos do ciclo de vida do agente (/new, /reset, /stop), Compaction da sessão, inicialização do Gateway e fluxo de mensagens. Eles são descobertos nos diretórios de hooks e gerenciados com openclaw hooks. Para interceptar chamadas de ferramentas no processo, use hooks de Plugin. Consulte Hooks.

​
Heartbeat

Heartbeat é um turno periódico da sessão principal (por padrão, a cada 30 minutos). Ele agrupa várias verificações (caixa de entrada, calendário e notificações) em um único turno do agente com o contexto completo da sessão. Os turnos de Heartbeat não criam registros de tarefas nem prolongam a validade da redefinição diária ou por inatividade da sessão. Use HEARTBEAT.md para uma pequena lista de verificação ou um bloco tasks: quando quiser verificações periódicas somente de itens vencidos dentro do próprio Heartbeat. Arquivos de Heartbeat vazios são ignorados como empty-heartbeat-file; o modo de tarefas somente no vencimento é ignorado como no-tasks-due. Os Heartbeats são adiados enquanto houver trabalhos cron ativos ou na fila, e heartbeat.skipWhenBusy também pode adiar um agente enquanto as faixas de subagente vinculadas à chave de sessão desse mesmo agente ou as faixas aninhadas estiverem ocupadas. Consulte Heartbeat.

​
Como eles funcionam em conjunto

  • Cron gerencia programações precisas (relatórios diários, revisões semanais) e lembretes de execução única. Todas as execuções cron criam registros de tarefas.
  • Heartbeat gerencia o monitoramento de rotina (caixa de entrada, calendário e notificações) em um único turno agrupado a cada 30 minutos.
  • Hooks reagem a eventos específicos (redefinições de sessão, Compaction e fluxo de mensagens) com scripts personalizados. Hooks de Plugin abrangem chamadas de ferramentas.
  • Ordens permanentes fornecem ao agente contexto persistente e limites de autoridade.
  • Fluxo de Tarefas coordena fluxos de várias etapas acima das tarefas individuais.
  • Tarefas acompanham automaticamente todo trabalho desvinculado para que você possa inspecioná-lo e auditá-lo.

​
Relacionados