Task System for Openclaw

A complete task lifecycle management system with SQLite persistence and automated monitoring for AI agents.

npmisantosh
v1.0.1
Feb 15, 2026
1
2.8k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install task-system

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install task-system 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 System?

The Task System is a comprehensive solution for managing the end-to-end lifecycle of agent activities. By leveraging a local SQLite database, this skill ensures that task data remains persistent across agent sessions, providing a reliable backbone for complex workflows within the Openclaw Skills ecosystem. It effectively replaces fragmented legacy tools with a unified interface for tracking, monitoring, and auditing agent performance. This skill is ideal for developers needing a robust way to ensure their agents stay on track and recover from unexpected interruptions.

Task System Use Cases

  • Monitoring long-running background processes through persistent heartbeat updates.
  • Persisting task history and state across agent restarts or system reboots.
  • Identifying and recovering stalled tasks using automated stuck-check scripts.
  • Auditing agent productivity and workload through structured daily status reports.

How Task System Works

  1. A new task is registered in the central SQLite database using the create-task command with the initial request text.
  2. The agent or system updates the heartbeat timestamp at regular intervals during execution to signal active progress.
  3. Monitoring scripts query the database to detect tasks with stale timestamps that exceed the allowed inactivity window.
  4. Once the objective is met, the task is marked as complete with relevant output notes stored for future reference and reporting.

Task System Setup

To install the Task System, execute the provided installation script within the skill directory:

./install.sh

Alternatively, you can manually add the skill scripts to your environment PATH:

export PATH="$HOME/.openclaw/agents/main/workspace/skills/task-system/scripts:$PATH"

Task System Data Schema & Taxonomy

The skill utilizes a SQLite database with a core tasks table organized as follows:

Column Type Description
request_text TEXT The original prompt or instruction for the task.
status TEXT The current lifecycle state (e.g., pending, started, completed).
priority INTEGER The task urgency level, used for ordering the queue.
last_updated DATETIME The timestamp of the last heartbeat or status change.
notes TEXT Additional context or the final result of the task.

Performance is optimized via indexes on (status, last_updated) and priority to allow for rapid status checks within the Openclaw Skills framework.

Task System Advanced Features

  • Integrated heartbeat monitoring to ensure real-time visibility into agent activity.
  • Automated stuck task detection to minimize downtime in autonomous workflows.
  • High-performance SQLite indexing for efficient task querying and priority management.
  • Consolidated command-line interface (task-system.sh) for streamlined interaction with Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*