A robust task management system for scheduling, monitoring, and controlling background jobs with real-time WebSocket updates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oc-task-scheduler
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oc-task-scheduler using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Task Scheduler?
The Task Scheduler is a comprehensive queue management system designed for Openclaw Skills developers who need to handle complex asynchronous operations. It supports immediate, scheduled, and recurring tasks with full support for priority-based execution and real-time status tracking via WebSockets.
By integrating this tool, agents can perform long-running operations like codebase analysis or daily backups without blocking the main execution thread. It provides both a Python API and a command-line interface, making it a versatile addition to any developer's Openclaw Skills toolkit.
Task Scheduler Use Cases
- Scheduling daily backups or periodic system maintenance.
- Managing high-priority background code analysis tasks.
- Implementing multi-step workflows with task dependencies.
- Real-time monitoring of long-running job progress via WebSocket connections.
How Task Scheduler Works
- Initialize the Task Scheduler daemon or import the library into your project.
- Create a task with specific parameters, priority levels, and optional cron schedules.
- The scheduler places tasks into a queue in a pending state and executes them based on priority and concurrency settings.
- Workers move tasks through the lifecycle: from running to completed, failed, or retrying states.
- Real-time updates are broadcast over a WebSocket connection to any connected monitoring clients.
Task Scheduler Setup
Install the necessary dependencies from the requirements file:
pip install -r requirements.txt
Start the scheduler daemon to begin processing background tasks:
python3 scripts/main.py daemon --ws-port 8080 --persist-tasks
Task Scheduler Data Schema & Taxonomy
The system uses a persistent SQLite database to track the lifecycle and metadata of all jobs. The schema includes the following primary fields:
| Field | Description |
|---|---|
| Task ID | Unique identifier for each job. |
| Description | Human-readable task purpose. |
| Status | Current lifecycle state (PENDING, RUNNING, COMPLETED, etc.). |
| Priority | Numeric value (1-4) determining execution order (LOW to URGENT). |
| Schedule | Cron expression for recurring tasks. |
| Params | JSON object containing task-specific arguments. |
Task Scheduler Advanced Features
- Multi-concurrency worker support for parallel task execution.
- Persistent storage using SQLite to ensure tasks survive system restarts.
- Event-driven hooks using the @scheduler.on_status_change decorator for custom automation integrations.
- WebSocket protocol support for building real-time dashboards and monitoring tools within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Multi-LLM Adapter
A universal adapter providing a unified interface for over 100 LLM providers with built-in failover and load balancing capabilities.
Weather Skill
A lightweight, API-key-free weather integration for retrieving current conditions and global forecasts via simple commands.
MegaETH Development Skill
A comprehensive development playbook for building high-performance, low-latency decentralized applications on the MegaETH network.
Magic Docs
Magic Docs transforms static Markdown files into living documents that automatically evolve as your AI agent discovers new technical insights and project changes.
Stuck - AI Help Request Generator
A specialized skill to extract error data and failed AI attempts into a clean, structured help request document.
LLM Tools
A universal tool definition system that allows developers to define functions once and automatically export them to any major LLM provider format.
Featured*
