Um auxiliar de tarefas em fila durável projetado para processamento em lote retomável e idempotente em ambientes task-father.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install queue-task
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 queue-task 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 é queue-task?
A skill queue-task é um utilitário especializado projetado para lidar com operações assíncronas de longa duração dentro do framework Openclaw Skills. Ela aborda o desafio comum de manter o estado em fluxos de trabalho distribuídos ou interrompidos, fornecendo um sistema de fila estruturado baseado em arquivos. Ao aproveitar o layout de diretório task-father, ela permite que os desenvolvedores construam automações que são confiáveis e escaláveis.
Em sua essência, esta skill foca na durabilidade e idempotência. Ela utiliza logs do tipo append-only para garantir que nenhum dado seja perdido durante o processamento e utiliza arquivos de trava (lock) para evitar condições de corrida durante execuções simultâneas. Quer você esteja processando grandes conjuntos de dados ou gerenciando fluxos de trabalho de agentes de várias etapas, o queue-task fornece a estrutura necessária para manter seus trabalhos organizados e retomáveis.
Casos de uso do queue-task
- Processamento de lotes de dados de alto volume que exigem rastreamento de estado retomável.
- Orquestração de tarefas de agentes de IA de longa duração que podem abranger várias sessões.
- Implementação de fluxos de trabalho idempotentes onde as tarefas não devem ser duplicadas ao tentar novamente.
- Agendamento de trabalhos recorrentes de manutenção ou sincronização via integrações cron dentro do Openclaw Skills.
Como o queue-task funciona
- O usuário fornece um slug de tarefa e parâmetros de configuração como tamanho do lote e agendamento.
- O sistema inicializa um diretório de tarefa dedicado contendo arquivos de estado (queue, progress, done, failed e lock).
- As tarefas são anexadas ao arquivo queue.jsonl para processamento sequencial ou em lote.
- Durante a execução, a skill verifica se há um arquivo lock ativo para garantir a exclusão mútua.
- À medida que os itens são processados, o progress.json é atualizado e os resultados são movidos para done.jsonl ou failed.jsonl.
- Se um processo for interrompido, a skill usa o arquivo de progresso para retomar exatamente de onde parou.
Configuração do queue-task
Para começar a usar o queue-task em seu ambiente Openclaw Skills, siga estas etapas:
- Inicialize a estrutura de tarefa para seu slug específico:
python3 scripts/queue_task.py init <slug>
- (Opcional) Configure manualmente seu ambiente se não estiver usando a inicialização via chat:
cp config.env.example config.env
# Edite o config.env com seu WORKSPACE_DIR e BATCH_SIZE
- Verifique a instalação e o status:
python3 scripts/queue_task.py status <slug>
Esquema de Dados e Taxonomia de queue-task
A skill organiza seu estado usando uma abordagem de banco de dados de arquivo simples (flat-file) dentro do diretório tasks. Isso garante portabilidade e transparência entre diferentes implementações do Openclaw Skills:
| Arquivo | Formato | Finalidade |
|---|---|---|
queue.jsonl |
JSONL | Armazena a lista de tarefas pendentes a serem processadas. |
progress.json |
JSON | Rastreia o deslocamento (offset) atual e os metadados do lote ativo. |
done.jsonl |
JSONL | Um registro permanente de tarefas concluídas com sucesso. |
failed.jsonl |
JSONL | Captura dados de tarefas e detalhes de erros para itens com falha. |
lock.json |
JSON | Impede a execução simultânea e armazena PIDs de processos. |
Recursos avançados do queue-task
- Suporte para detecção de trava (lock) obsoleta e limpeza manual para garantir alta disponibilidade.
- Geração de templates de worker do supervisor para monitoramento de processos e reinicializações automáticas.
- Compatibilidade nativa com expressões cron do Openclaw Skills para agendamento automatizado.
- Configuração portátil através de variáveis de ambiente (config.env) para implantação contínua entre máquinas.
- Log em JSONL do tipo append-only para operações de escrita de alta performance e auditabilidade.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Integração com OneDrive
Uma ferramenta especializada para agentes de IA moverem e renomearem automaticamente arquivos locais para o Microsoft OneDrive para compartilhamento imediato em plataformas de chat móvel.
Pesquisa Tavily
Integre recursos de pesquisa na web em tempo real aos seus agentes de IA usando a API Tavily para recuperação de dados estruturados e altamente relevantes.
Firecrawl Scraper
Uma poderosa ferramenta de raspagem e rastreamento da web que utiliza a API Firecrawl para transformar sites em dados limpos e estruturados, otimizados para aplicações de IA.
Geração de Imagem e Vídeo por IA Perstudio
Um mecanismo de mídia de IA de nível profissional para Openclaw Skills que transforma linguagem natural em imagens, vídeos e áudio de alta fidelidade.
Preenchimento Automático Seguro (Integração com 1Password)
Automatize logins na web de forma segura usando credenciais do 1Password, mantendo os segredos privados do agente de IA.
Secure Shopper
Um assistente de compras de IA assíncrono que pesquisa produtos em vários sites e realiza checkouts seguros usando automação baseada no 1Password.
Apresentou*
