Um sistema robusto de gerenciamento de tarefas projetado para garantir continuidade, persistência de estado e recuperação automatizada para agentes de IA durante operações de longa duração.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install task-persistence
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o task-persistence usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Persistência de Tarefas?
A habilidade de Persistência de Tarefas fornece uma camada de infraestrutura crítica para manter o estado do agente através de reinicializações e operações complexas de várias etapas. Ao implementar uma camada de persistência padronizada, ela evita a perda de progresso durante interrupções de gateway ou ciclos de sistema. Esta habilidade é essencial para desenvolvedores que criam Openclaw Skills confiáveis que precisam lidar com tarefas assíncronas ou manter uma memória de fluxos de trabalho ativos.
Em sua essência, a habilidade gerencia o registro de tarefas, filas de prioridade e snapshots de sessão. Ela permite que o agente "lembre" exatamente onde parou, proporcionando uma experiência de usuário contínua, mesmo quando o ambiente subjacente é redefinido. Isso a torna um componente fundamental para implantações de agentes de IA de alta disponibilidade.
Casos de uso do Persistência de Tarefas
- Retomar automaticamente tarefas de processamento de arquivos ou análise de dados de longa duração após uma reinicialização do sistema.
- Rastrear o status de várias operações simultâneas para fornecer atualizações de progresso aos usuários.
- Recuperar o contexto de sessão perdido por meio de snapshots quando um gateway de IA reinicia inesperadamente.
- Organizar filas de tarefas por prioridade para garantir que as operações críticas sejam concluídas primeiro.
- Auditar tarefas concluídas e com falha para manter um registro histórico da atividade do agente.
Como o Persistência de Tarefas funciona
- Ao iniciar uma operação de várias etapas, o agente registra uma nova tarefa com metadados exclusivos por meio do gerenciador de tarefas.
- O sistema cria um registro de persistência no espaço de trabalho, capturando o tipo de tarefa, prioridade e estado inicial.
- Durante a execução, o agente salva periodicamente snapshots de sessão para preservar variáveis de ambiente e contexto.
- Após uma reinicialização do gateway, o sistema executa um modo de verificação-reinicialização para identificar quaisquer tarefas que foram interrompidas.
- O agente analisa a lista de tarefas ativas e os arquivos de recuperação para retomar o trabalho ou relatar o status ao usuário.
Configuração do Persistência de Tarefas
Esta habilidade requer python3 e uma variável de ambiente OPENCLAW_WORKSPACE (o padrão é /workspace). Nenhuma dependência externa é necessária, pois utiliza a biblioteca padrão do Python.
Inicialize a verificação de recuperação após qualquer reinicialização:
python3 {baseDir}/scripts/main.py --mode check-restart --workspace /workspace
Registre uma nova tarefa antes de iniciar operações longas:
python3 {baseDir}/scripts/task_manager.py \
--action add \
--task-id "task_$(date +%s)" \
--task-type "processing" \
--priority normal \
--workspace /workspace
Esquema de Dados e Taxonomia de Persistência de Tarefas
A habilidade mantém um diretório estruturado dentro do espaço de trabalho para garantir a integridade dos dados para as Openclaw Skills:
| Caminho | Descrição |
|---|---|
tasks/task_queue.json |
A fila primária para todas as tarefas registradas. |
tasks/completed/ |
Armazenamento de arquivos JSON de tarefas concluídas com sucesso. |
memory/session_snapshots/ |
Diretório contendo snapshots de estado de sessão serializados. |
persistence/active_tasks.json |
Rastreamento em tempo real das tarefas atualmente em andamento. |
persistence/gateway_state.json |
Metadados e informações de pulsação (heartbeat) para o gateway. |
Recursos avançados do Persistência de Tarefas
- Suporte para tipos de tarefas personalizados e marcação de metadados para fluxos de trabalho especializados.
- Snapshots de sessão automatizados para capturar contexto profundo além de IDs de tarefas simples.
- Lógica de execução baseada em prioridade para gerenciar a alocação de recursos em ambientes multitarefa.
- Log detalhado de falhas e arquivamento de tarefas para depuração de implementações complexas de Openclaw Skills.
- Integração perfeita com monitores de pulsação para detectar e responder a falhas de ambiente em tempo real.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Monitor de Sessão
Uma ferramenta automatizada de monitoramento de sessão que rastreia o consumo de tokens, metadados do modelo e uso de contexto para agentes de IA.
Pacote para Novos Jogadores 800: Guia de Otimização de Implantação OpenClaw
Um guia de implantação testado em batalha e um pacote de habilidades projetado para otimizar o OpenClaw para uso imediato e de alto desempenho.
DomainAgentHub
Um hub inteligente de especialistas de domínio que analisa tarefas para recomendar soluções maduras ou despachar subagentes de IA especializados.
Habilidade de Coordenador Multi-Agente
Uma poderosa habilidade de orquestração que permite a um agente de IA principal gerar, gerenciar e integrar resultados de sub-agentes especializados.
Teste de Upload 2026
Uma habilidade de validação diagnóstica projetada para verificar o fluxo de trabalho de publicação de ponta a ponta e a conformidade de metadados para o ecossistema Openclaw.
Diário de Saúde Pessoal
Uma habilidade abrangente de rastreamento de saúde para registrar sintomas diários, monitorar sinais vitais e gerar resumos médicos estruturados.
Apresentou*
