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.