Automação e tarefas

OpenClaw executa trabalhos 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 integram.

# Guia rápido de decisão

flowchart TD
    START([What do you need?]) --> Q1{Schedule work?}
    START --> Q2{Track detached work?}
    START --> Q3{Orchestrate multi-step flows?}
    START --> Q4{React to lifecycle events?}
    START --> Q5{Give the agent persistent instructions?}
    START --> Q6{Remember a natural follow-up?}

    Q1 -->|Yes| Q1a{Exact timing or flexible?}
    Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
    Q1a -->|Flexible| HEARTBEAT[Heartbeat]

    Q2 -->|Yes| TASKS[Background Tasks]
    Q3 -->|Yes| FLOW[Task Flow]
    Q4 -->|Yes| HOOKS[Hooks]
    Q5 -->|Yes| SO[Standing Orders]
    Q6 -->|Yes| COMMITMENTS[Inferred Commitments]

Caso de uso	Recomendado	Por quê
Enviar relatório diário exatamente às 9h	Tarefas agendadas (Cron)	Horário exato, execução isolada
Lembre-me em 20 minutos	Tarefas agendadas (Cron)	Disparo único com horário preciso (--at)
Executar análise aprofundada semanal	Tarefas agendadas (Cron)	Tarefa independente, pode usar modelo diferente
Verificar a caixa de entrada a cada 30 min	Heartbeat	Agrupa com outras verificações, ciente do contexto
Monitorar calendário para eventos próximos	Heartbeat	Encaixe natural para percepção periódica
Verificar depois de uma entrevista mencionada	Compromissos inferidos	Acompanhamento semelhante à memória, sem pedido de lembrete exato
Check-in cuidadoso após contexto do usuário	Compromissos inferidos	Limitado ao mesmo agente e canal
Inspecionar status de um subagente ou execução ACP	Tarefas em segundo plano	O registro de tarefas acompanha todo trabalho desvinculado
Auditar o que foi executado 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ões
Executar um script ao redefinir a sessão	Hooks	Orientado a eventos, dispara em eventos de ciclo de vida
Executar código a cada 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 todas as sessões

# Tarefas agendadas (Cron) vs Heartbeat

Dimensão	Tarefas agendadas (Cron)	Heartbeat
Temporização	Exata (expressões cron, disparo único)	Aproximada (padrão a cada 30 min)
Contexto da sessão	Novo (isolado) ou compartilhado	Contexto completo da sessão principal
Registros de tarefa	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

Use tarefas agendadas (Cron) quando precisar de temporização precisa ou execução isolada. Use Heartbeat quando o trabalho se beneficia do contexto completo da sessão e a temporização aproximada é suficiente.

# Conceitos principais

# Tarefas agendadas (cron)

Cron é o agendador integrado do Gateway para temporização precisa. Ele persiste trabalhos, desperta 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 disparo único, expressões recorrentes e gatilhos de webhook de entrada.

Consulte Tarefas agendadas.

# Tarefas

O registro de tarefas em segundo plano acompanha todo trabalho desvinculado: execuções ACP, criação 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 a partir de conversas normais, limita-os ao mesmo agente e canal e entrega check-ins vencidos por meio do Heartbeat. Lembretes exatos solicitados pelo usuário ainda pertencem ao cron.

Consulte 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ões e openclaw tasks flow list|show|cancel para inspeção.

Consulte Task Flow.

# Ordens permanentes

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

Consulte 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 a partir de diretórios e podem ser gerenciados com openclaw hooks. Para interceptação de chamadas de ferramenta em processo, use hooks de Plugin.

Consulte 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 tarefa e não estendem a atualização da redefinição diária/ociosa da sessão. Use HEARTBEAT.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 de vencidos é ignorado como no-tasks-due. Heartbeats são adiados enquanto trabalhos cron estão ativos ou enfileirados, e heartbeat.skipWhenBusy também pode adiá-los enquanto subagentes ou lanes aninhadas estão ocupados.

Consulte Heartbeat.

# Como funcionam juntos

• Cron lida com agendamentos precisos (relatórios diários, revisões semanais) e lembretes de disparo único. Todas as execuções cron criam registros de tarefa.
• 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 acompanham automaticamente todo trabalho desvinculado para que você possa inspecioná-lo e auditá-lo.

# Relacionados

• Tarefas agendadas — agendamento preciso e lembretes de disparo único
• Compromissos inferidos — check-ins de acompanhamento semelhantes à memória
• Tarefas em segundo plano — registro de tarefas para todo trabalho desvinculado
• Task Flow — orquestração durável de fluxo 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