Automação

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

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]

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

• Tarefas Agendadas — agendamento preciso e lembretes de execução única
• Compromissos Inferidos — contatos de acompanhamento semelhantes à memória
• Tarefas em Segundo Plano — registro de tarefas para todo trabalho desvinculado
• Fluxo de Tarefas — orquestração durável de fluxos de várias etapas
• Hooks — scripts de ciclo de vida orientados a eventos
• Hooks de Plugin — hooks no processo para ferramentas, prompts, mensagens 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