A persistent task management system designed to track projects and todo lists across multiple AI agent sessions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install task-runner
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 task-runner 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 Runner?
Task Runner is a specialized utility that enables long-term project management within an AI agent environment. By utilizing persistent storage, this skill allows users to maintain state across different sessions, ensuring that no todo item or milestone is lost when a conversation ends. It bridges the gap between ephemeral interactions and structured project execution.
This tool is particularly valuable for developers and researchers using Openclaw Skills who need to manage complex, multi-step workflows. With built-in support for projects, priority levels, and security-focused file exports, it serves as a central hub for tracking productivity and autonomous agent progress.
Task Runner Use Cases
- Managing long-term coding projects that span multiple AI sessions.
- Tracking autonomous agent experiments and iterative learning cycles.
- Organizing weekly sprint planning and daily task backlogs.
- Generating progress reports for stakeholders via markdown exports.
- Maintaining high-priority bug lists during debugging phases.
How Task Runner Works
- Add tasks to the persistent database with specific project tags and priority levels.
- Query the current task list using filters to focus on specific projects or pending items.
- Update task status to completed or adjust priorities as project requirements change.
- Export project data to markdown files for external documentation and sharing.
- Access the tasks_db.json file within the workspace to ensure data survives session restarts.
Task Runner Setup
To use this skill within the Openclaw Skills ecosystem, ensure your environment has access to the workspace directory. No additional installation is required beyond the standard skill deployment.
# Verify the task runner is accessible
task_runner.py list
# Configuration is handled automatically in:
~/.openclaw/workspace/tasks_db.json
Task Runner Data Schema & Taxonomy
The skill organizes data in a structured JSON format, tracking the following metadata for every task:
| Attribute | Description |
|---|---|
| Task ID | Unique numerical identifier for command-line operations |
| Project | User-defined string to group related tasks |
| Priority | levels: high (🔴), medium (🟡), or low (🟢) |
| Status | Tracking for pending (⏳) versus completed (✅) states |
| Timestamps | Records for creation date and completion time |
| Description | The core text detailing the task requirements |
Task Runner Advanced Features
- Path Validation Security: Prevents malicious writes by restricting exports to safe directories like the home folder or workspace.
- Markdown Export Engine: Transforms internal JSON task data into clean, readable markdown documents.
- Multi-Session Persistence: Ensures data longevity by storing tasks outside the volatile session memory.
- Cross-Skill Integration: Works alongside other Openclaw Skills to combine research notes with actionable tasks.
SKILL.md
Loading
Related Openclaw Skills
Security Checker
A specialized static analysis tool designed to scan Python-based skills for security vulnerabilities and hardcoded credentials before deployment.
Seasonal Planting Guide
A technical command-line tool for generating region-specific planting calendars and managing botanical data based on USDA Hardiness Zones.
Research Assistant
A sophisticated knowledge management tool for agents to structure, store, and retrieve research notes across multiple sessions.
Plant Tracker
A sophisticated garden management utility for Openclaw Skills that tracks plant health, care logs, and harvest data through a structured CLI interface.
URL Fetcher
A lightweight, zero-dependency Python tool for fetching web content and converting HTML to markdown securely.
A-Share Glossary Tutor
A structured tutor and note-taking assistant for mastering Chinese A-share financial indicators and market terminology.
Featured*
