ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

queue-task

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

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/moodykong/queue-task
Or

queue-task

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

Layout (task-father only):

  • <WORKSPACE_DIR>/<TASKS_DIR>/<slug>/...

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 <slug>

Smoke test:

  • python3 scripts/queue_task.py status <slug>

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 <slug>
  • Status:
    • python3 scripts/queue_task.py status <slug>
  • Clear stale lock:
    • python3 scripts/queue_task.py clear-stale-lock <slug>
  • 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.
Read Full Documentation on GitHub

Metadata

Author@moodykong
Stars1401
Views0
Updated2026-02-24
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-moodykong-queue-task": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

skill-father

Authoritative skill-creation standards (Boss). Use when creating or updating OpenClaw skills so they are portable, reproducible, include prerequisites checks, and have a guided installation/onboarding flow that persists machine-specific config in skill-local config files.

moodykong 1401

ssh-op

Use the ssh-op helper script to load an SSH private key from 1Password (op) into an in-memory ssh-agent and then run ssh. Use when connecting to hosts that require the 1Password-managed key, troubleshooting ssh-op, or onboarding a new machine by configuring the 1Password vault/item and adding SSH host aliases to ~/.ssh/config.

moodykong 1401

secure-shopper

Asynchronous shopping research + checkout using secure-autofill (1Password-backed browser filling) with results recorded to workspace artifacts.

moodykong 1401

secure-autofill

1Password-backed credential filling via vault_suggest/vault_fill (plugin tools).

moodykong 1401

onedrive-integration

Copy large/long files to OneDrive for sharing when the user is on Telegram or WhatsApp and wants to view a full document or long file. Use to place files into OneDrive under an OpenClaw folder and provide the new filename/location.

moodykong 1401