🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Queue Task

by @moodykong

Durable queue-task helper for resumable, idempotent batch jobs in task-father task folders.

Versionv0.1.0
Downloads1,361
Installs5
TERMINAL
clawhub install queue-task

πŸ“– About This Skill


name: queue-task description: Durable queue-task helper for resumable, idempotent batch jobs in task-father task folders.

queue-task

Use this skill for durable long-running queue jobs with resumable batches.

Layout (task-father only):

  • ///...
  • State files:

  • queue.jsonl
  • progress.json
  • done.jsonl
  • failed.jsonl
  • lock.json
  • Prerequisites

  • python3 --version
  • openclaw status
  • openclaw cron --help
  • Configuration (portable)

    Skill-local config:

  • Example: config.env.example
  • Real machine config: config.env
  • Keys:

  • WORKSPACE_DIR
  • TASKS_DIR
  • BATCH_SIZE
  • LOCK_STALE_MINUTES
  • CRON_EXPR
  • CRON_TZ
  • DELIVERY_MODE
  • AGENT_ID
  • Initialization / Installation / Onboarding

    Preferred (chat-first)

    Provide: 1) task slug 2) batch size 3) lock stale minutes 4) schedule and timezone

    Then initialize:

  • python3 scripts/queue_task.py init
  • Smoke test:

  • python3 scripts/queue_task.py status
  • Optional (terminal)

  • cp config.env.example config.env
  • Edit config.env
  • Run init/status commands above.
  • Commands

  • Init files:
  • - python3 scripts/queue_task.py init
  • Status:
  • - python3 scripts/queue_task.py status
  • Clear stale lock:
  • - python3 scripts/queue_task.py clear-stale-lock
  • Print worker template:
  • - python3 scripts/queue_task.py print-supervisor-template

    Usage notes

  • Prefer append-only JSONL logs.
  • Process small batches.
  • Update progress.json after each item.
  • Keep idempotency keys task-defined.
  • Use lock file to avoid concurrent runs.
  • βš™οΈ Configuration

  • python3 --version
  • openclaw status
  • openclaw cron --help