O OpenClaw executa trabalho em segundo plano por meio de tarefas, trabalhos agendados, compromissos inferidos, hooks de eventos e instruções permanentes. Esta página ajuda você a escolher o mecanismo certo e entender como eles se encaixam.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Guia rápido de decisão
| Caso de uso | Recomendado | Por quê |
|---|---|---|
| Enviar relatório diário às 9h em ponto | Tarefas Agendadas (Cron) | Horário exato, execução isolada |
| Lembre-me em 20 minutos | Tarefas Agendadas (Cron) | Execução única com horário preciso (--at) |
| Executar análise profunda semanal | Tarefas Agendadas (Cron) | Tarefa independente, pode usar modelo diferente |
| Verificar caixa de entrada a cada 30 min | Heartbeat | Agrupa com outras verificações, ciente de contexto |
| Monitorar calendário para eventos futuros | Heartbeat | Encaixe natural para percepção periódica |
| Fazer check-in após uma entrevista mencionada | Compromissos Inferidos | Acompanhamento semelhante a memória, sem solicitação exata de lembrete |
| Check-in cuidadoso após contexto do usuário | Compromissos Inferidos | Escopado para o mesmo agente e canal |
| Inspecionar status de um subagente ou execução ACP | Tarefas em Segundo Plano | O ledger de tarefas rastreia todo trabalho destacado |
| Auditar o que rodou e quando | Tarefas em Segundo Plano | openclaw tasks list e openclaw tasks audit |
| Pesquisa em várias etapas e depois resumo | Task Flow | Orquestração durável com rastreamento de revisão |
| Executar um script ao redefinir sessão | Hooks | Orientado a eventos, dispara em eventos de ciclo de vida |
| Executar código em toda chamada de ferramenta | Hooks de Plugin | Hooks em processo podem interceptar chamadas de ferramenta |
| Sempre verificar conformidade antes de responder | Ordens Permanentes | Injetadas automaticamente em toda sessão |
Tarefas Agendadas (Cron) vs Heartbeat
| Dimensão | Tarefas Agendadas (Cron) | Heartbeat |
|---|---|---|
| Temporização | Exata (expressões cron, execução única) | Aproximada (padrão a cada 30 min) |
| Contexto da sessão | Novo (isolado) ou compartilhado | Contexto completo da sessão principal |
| Registros de tarefas | Sempre criados | Nunca criados |
| Entrega | Canal, webhook ou silenciosa | Inline na sessão principal |
| Melhor para | Relatórios, lembretes, trabalhos em segundo plano | Verificações de caixa de entrada, calendário, notificações |
Conceitos principais
Tarefas agendadas (cron)
Cron é o agendador integrado do Gateway para temporização precisa. Ele persiste trabalhos, acorda o agente no momento certo e pode entregar a saída a um canal de chat ou endpoint de webhook. Oferece suporte a lembretes de execução única, expressões recorrentes e acionadores de webhook de entrada. Veja Tarefas Agendadas.Tarefas
O ledger de tarefas em segundo plano rastreia todo trabalho destacado: execuções ACP, criação de subagentes, execuções cron isoladas e operações CLI. Tarefas são registros, não agendadores. Useopenclaw tasks list e openclaw tasks audit para inspecioná-las.
Veja Tarefas em Segundo Plano.
Compromissos inferidos
Compromissos são memórias de acompanhamento opcionais e de curta duração. O OpenClaw os infere a partir de conversas normais, os escopa para o mesmo agente e canal, e entrega check-ins vencidos por meio do Heartbeat. Lembretes exatos solicitados pelo usuário ainda pertencem ao cron. Veja Compromissos Inferidos.Task Flow
Task Flow é o substrato 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 gerenciados e espelhados, rastreamento de revisão eopenclaw tasks flow list|show|cancel para inspeção.
Veja Task Flow.
Ordens permanentes
Ordens permanentes concedem ao agente autoridade operacional permanente para programas definidos. Elas ficam em arquivos do workspace (normalmenteAGENTS.md) e são injetadas em toda sessão. Combine com cron para aplicação baseada em tempo.
Veja Ordens Permanentes.
Hooks
Hooks internos são scripts orientados a eventos acionados por eventos de ciclo de vida do agente (/new, /reset, /stop), Compaction da sessão, inicialização do Gateway e fluxo de mensagens. Eles são descobertos automaticamente em diretórios e podem ser gerenciados com openclaw hooks. Para interceptação de chamadas de ferramenta em processo, use hooks de Plugin.
Veja Hooks.
Heartbeat
Heartbeat é um turno periódico da sessão principal (padrão a cada 30 minutos). Ele agrupa várias verificações (caixa de entrada, calendário, notificações) em um turno do agente com contexto completo da sessão. Turnos de Heartbeat não criam registros de tarefas e não estendem a atualização de redefinição diária/ociosa da sessão. UseHEARTBEAT.md para uma pequena lista de verificação, ou um bloco tasks: quando quiser verificações periódicas apenas de itens vencidos dentro do próprio Heartbeat. Arquivos de Heartbeat vazios são ignorados como empty-heartbeat-file; o modo de tarefa apenas com vencidos é ignorado como no-tasks-due. Heartbeats são adiados enquanto trabalho cron está ativo ou enfileirado, e heartbeat.skipWhenBusy também pode adiar um agente enquanto o subagente com chave de sessão desse mesmo agente ou lanes aninhadas estão ocupadas.
Veja Heartbeat.
Como eles funcionam juntos
- Cron lida com agendamentos precisos (relatórios diários, revisões semanais) e lembretes de execução única. Todas as execuções cron criam registros de tarefas.
- Heartbeat lida com monitoramento rotineiro (caixa de entrada, calendário, notificações) em um turno agrupado a cada 30 minutos.
- Hooks reagem a eventos específicos (redefinições de sessão, Compaction, fluxo de mensagens) com scripts personalizados. Hooks de Plugin cobrem chamadas de ferramenta.
- Ordens permanentes dão ao agente contexto persistente e limites de autoridade.
- Task Flow coordena fluxos de várias etapas acima de tarefas individuais.
- Tarefas rastreiam automaticamente todo trabalho destacado para que você possa inspecioná-lo e auditá-lo.
Relacionados
- Tarefas Agendadas — agendamento preciso e lembretes de execução única
- Compromissos Inferidos — check-ins de acompanhamento semelhantes a memória
- Tarefas em Segundo Plano — ledger de tarefas para todo trabalho destacado
- Task Flow — orquestração durável de fluxos de várias etapas
- Hooks — scripts de ciclo de vida orientados a eventos
- hooks de Plugin — hooks em processo de ferramenta, prompt, mensagem e ciclo de vida
- Ordens Permanentes — instruções persistentes do agente
- Heartbeat — turnos periódicos da sessão principal
- Referência de Configuração — todas as chaves de configuração