Quando usar Task Flow
Use Task Flow quando o trabalho abranger várias etapas sequenciais ou ramificadas e você precisar de rastreamento durável de progresso entre reinicializações do gateway. Para operações únicas em segundo plano, uma tarefa simples é suficiente.| Cenário | Uso |
|---|---|
| Trabalho único em segundo plano | Tarefa simples |
| Pipeline de várias etapas (A depois B depois C) | Task Flow (gerenciado) |
| Observar tarefas criadas externamente | Task Flow (espelhado) |
| Lembrete único | Trabalho Cron |
Padrão confiável de workflow agendado
Para workflows recorrentes, como briefings de inteligência de mercado, trate o agendamento, a orquestração e as verificações de confiabilidade como camadas separadas:- Use Tarefas Agendadas para temporização.
- Use uma sessão Cron persistente quando o workflow precisar se basear em contexto anterior.
- Use Lobster para etapas determinísticas, gates de aprovação e tokens de retomada.
- Use Task Flow para rastrear a execução de várias etapas entre tarefas filhas, esperas, novas tentativas e reinicializações do gateway.
session:<id> em vez de isolated quando o workflow recorrente precisar de histórico deliberado, resumos de execuções anteriores ou contexto permanente. Use isolated quando cada execução deve começar do zero e todo o estado necessário está explícito no workflow.
Dentro do workflow, coloque as verificações de confiabilidade antes da etapa de resumo do LLM:
- Disponibilidade do navegador e escolha de perfil, por exemplo
openclawpara estado gerenciado ouuserquando uma sessão do Chrome autenticada for necessária. Consulte Navegador. - Credenciais de API e cota para cada fonte.
- Alcance de rede para endpoints necessários.
- Ferramentas necessárias habilitadas para o agente, como
lobster,browserellm-task. - Destino de falha configurado para Cron para que falhas de pré-voo fiquem visíveis. Consulte Tarefas Agendadas.
sourceUrl, retrievedAt e asOf na saída. Use Tarefa LLM quando precisar de uma etapa de modelo validada por esquema dentro do workflow.
Para workflows reutilizáveis de equipe ou comunidade, empacote a CLI, os arquivos .lobster e quaisquer notas de configuração como uma skill ou Plugin e publique por meio do ClawHub. Mantenha guardrails específicos do workflow nesse pacote, a menos que a API de Plugin não tenha uma capacidade genérica necessária.
Modos de sincronização
Modo gerenciado
Task Flow controla o ciclo de vida de ponta a ponta. Ele cria tarefas como etapas do fluxo, conduz essas tarefas até a conclusão e avança o estado do fluxo automaticamente. Exemplo: um fluxo de relatório semanal que (1) coleta dados, (2) gera o relatório e (3) o entrega. Task Flow cria cada etapa como uma tarefa em segundo plano, aguarda a conclusão e passa para a próxima etapa.Modo espelhado
Task Flow observa tarefas criadas externamente e mantém o estado do fluxo sincronizado sem assumir a propriedade da criação das tarefas. Isso é útil quando as tarefas se originam de trabalhos Cron, comandos da CLI ou outras fontes e você quer uma visão unificada do progresso delas como um fluxo. Exemplo: três trabalhos Cron independentes que, juntos, formam uma rotina de “operações matinais”. Um fluxo espelhado rastreia o progresso coletivo sem controlar quando ou como eles são executados.Estado durável e rastreamento de revisões
Cada fluxo persiste seu próprio estado e rastreia revisões para que o progresso sobreviva a reinicializações do gateway. O rastreamento de revisões permite detectar conflitos quando várias fontes tentam avançar o mesmo fluxo simultaneamente. O registro de fluxos usa SQLite com manutenção limitada do write-ahead log, incluindo checkpoints periódicos e no encerramento, para que gateways de longa execução não retenham arquivos auxiliaresregistry.sqlite-wal ilimitados.
Comportamento de cancelamento
openclaw tasks flow cancel define uma intenção de cancelamento persistente no fluxo. As tarefas ativas dentro do fluxo são canceladas, e nenhuma nova etapa é iniciada. A intenção de cancelamento persiste entre reinicializações, portanto um fluxo cancelado continua cancelado mesmo que o gateway reinicie antes de todas as tarefas filhas terminarem.
Comandos da CLI
| Comando | Descrição |
|---|---|
openclaw tasks flow list | Mostra fluxos rastreados com status e modo de sincronização |
openclaw tasks flow show <id> | Inspeciona um fluxo por id de fluxo ou chave de busca |
openclaw tasks flow cancel <id> | Cancela um fluxo em execução e suas tarefas ativas |
Como fluxos se relacionam a tarefas
Fluxos coordenam tarefas, não as substituem. Um único fluxo pode conduzir várias tarefas em segundo plano ao longo de sua vida útil. Useopenclaw tasks para inspecionar registros de tarefas individuais e openclaw tasks flow para inspecionar o fluxo orquestrador.
Relacionado
- Tarefas em Segundo Plano — o ledger de trabalho desacoplado que os fluxos coordenam
- CLI: tarefas — referência de comandos da CLI para
openclaw tasks flow - Visão Geral de Automação — todos os mecanismos de automação em uma visão geral
- Trabalhos Cron — trabalhos agendados que podem alimentar fluxos