queue-task para Openclaw

Un ayudante de tareas en cola duradero diseñado para el procesamiento por lotes reanudable e idempotente en entornos task-father.

moodykong
v0.1.0
Feb 22, 2026
0
2k
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install queue-task

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar queue-task usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es queue-task?

La habilidad queue-task es una utilidad especializada diseñada para manejar operaciones asíncronas de larga duración dentro del marco de Openclaw Skills. Aborda el desafío común de mantener el estado en flujos de trabajo distribuidos o interrumpidos mediante la provisión de un sistema de colas estructurado basado en archivos. Al aprovechar el diseño de directorios task-father, permite a los desarrolladores crear automatizaciones que son tanto confiables como escalables.

En su núcleo, esta habilidad se centra en la durabilidad y la idempotencia. Utiliza registros de solo anexar para garantizar que no se pierdan datos durante el procesamiento y emplea archivos de bloqueo para evitar condiciones de carrera durante las ejecuciones concurrentes. Ya sea que esté procesando grandes conjuntos de datos o gestionando flujos de trabajo de agentes de varios pasos, queue-task proporciona el andamiaje necesario para mantener sus trabajos organizados y reanudables.

Casos de uso de queue-task

  • Procesamiento de lotes de datos de gran volumen que requieren seguimiento de estado reanudable.
  • Orquestación de tareas de agentes de IA de larga duración que pueden abarcar múltiples sesiones.
  • Implementación de flujos de trabajo idempotentes donde las tareas no deben duplicarse al reintentar.
  • Programación de trabajos de mantenimiento o sincronización recurrentes a través de integraciones cron dentro de Openclaw Skills.

Cómo funciona queue-task

  1. El usuario proporciona un identificador (slug) de tarea y parámetros de configuración como el tamaño del lote y el horario.
  2. El sistema inicializa un directorio de tareas dedicado que contiene archivos de estado (cola, progreso, completado, fallido y bloqueo).
  3. Las tareas se anexan al archivo queue.jsonl para el procesamiento secuencial o por lotes.
  4. Durante la ejecución, la habilidad verifica si hay un archivo de bloqueo activo para garantizar la exclusión mutua.
  5. A medida que se procesan los elementos, se actualiza progress.json y los resultados se mueven a done.jsonl o failed.jsonl.
  6. Si se interrumpe un proceso, la habilidad utiliza el archivo de progreso para reanudar exactamente donde se quedó.

Configuración de queue-task

Para comenzar con queue-task en su entorno de Openclaw Skills, siga estos pasos:

  1. Inicialice la estructura de tareas para su slug específico:
python3 scripts/queue_task.py init <slug>
  1. (Opcional) Configure manualmente su entorno si no utiliza la inicialización asistida por chat:
cp config.env.example config.env
# Edite config.env con su WORKSPACE_DIR y BATCH_SIZE
  1. Verifique la instalación y el estado:
python3 scripts/queue_task.py status <slug>

Esquema de datos y taxonomía de queue-task

La habilidad organiza su estado utilizando un enfoque de base de datos de archivos planos dentro del directorio tasks. Esto garantiza la portabilidad y transparencia entre las diferentes implementaciones de Openclaw Skills:

Archivo Formato Propósito
queue.jsonl JSONL Almacena la lista de tareas pendientes por procesar.
progress.json JSON Rastrea el desplazamiento actual y los metadatos del lote activo.
done.jsonl JSONL Un registro permanente de tareas completadas con éxito.
failed.jsonl JSONL Captura datos de tareas y detalles de errores para elementos fallidos.
lock.json JSON Evita la ejecución concurrente y almacena los PID de los procesos.

Funciones avanzadas de queue-task

  • Soporte para detección de bloqueos obsoletos y limpieza manual para garantizar una alta disponibilidad.
  • Generación de plantillas de trabajador supervisor para el monitoreo de procesos y reinicios automáticos.
  • Compatibilidad nativa con expresiones cron de Openclaw Skills para la programación automatizada.
  • Configuración portátil mediante variables de entorno (config.env) para una implementación sin problemas entre máquinas.
  • Registro JSONL de solo anexar para operaciones de escritura de alto rendimiento y auditabilidad.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*