A personal task and schedule management assistant that interprets natural language to create, edit, recur, and export schedules and reminders.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install liuxiaoying-task-planner
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 liuxiaoying-task-planner 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 Planner?
The Task Planner is a highly versatile personal productivity and schedule management assistant designed for AI-powered developer workflows. As a core tool in the Openclaw Skills library, it allows users to organize their professional agendas, project deadlines, and repeating tasks using intuitive natural language interfaces. Rather than dealing with tedious forms or complex calendar applications, developers can instruct the assistant using conversational commands to book, reschedule, categorize, or delete schedule blocks.
In addition to parsing deadlines and lead-time reminders, this skill comes equipped with a highly optimized calendar compilation engine. It aggregates schedule records into beautifully structured Markdown tables suitable for instant status reviews, reporting, or printing directly to PDF documents.
Task Planner Use Cases
- Natural Language Task Creation: Registering complex tasks simply by typing or saying "Remind me to review the pull request tomorrow at 10 AM."
- Dynamic Recurring Reminders: Setting up daily, weekly, monthly, or yearly operational tasks with auto-generating subsequences that calculate their next due dates upon completion.
- Frictionless Rescheduling: Updating task deadlines or titles without memorizing system IDs, relying instead on clean semantic phrase matching.
- Structured Status Reporting: Exporting filtered weekly or monthly itineraries into clean Markdown files for clean sprint scheduling or physical PDF printing.
- Voice-to-Task Integration: Log schedule items on the move using WeChat voice message conversions directly processed into actionable tasks.
How Task Planner Works
- Request Intake: The system registers conversational triggers or natural language prompts (e.g., "Add daily standup at 9:00 AM").
- Audio Transcription (Optional): If voice files are submitted via integrations like WeChat, a dedicated Python utility translates the audio file to text using Whisper APIs.
- Natural Language Parsing: The agent extracts task metadata including title, deadline dates, priority tiers, category groups, and reminder offsets.
- Database Registration: The parsed task is stored in the task database, resolving priority and calculating precise timestamps for reminders.
- Cron Execution: A scheduled background system cron job executes hourly, evaluating active schedules to dispatch notifications at defined thresholds.
- Recurrence Planning: Upon checking off a recurring task, the system automatically checks the end-condition, then spawns the next occurrence.
- Document Assembly: On-demand queries generate structured calendar templates stored locally as Markdown lists and tables.
Task Planner Setup
System Requirements & Installation
To configure the voice translation capabilities, define your API credentials and install the required dependencies:
# Configure your API key for transcription services
export OPENAI_API_KEY="your-api-key"
# Install the necessary library integration
pip install openai
Audio Transcription Pipeline
Test the speech-to-text integration locally by passing your input voice clip to the core transcription module:
python scripts/transcribe.py <path_to_audio_file>
Configuring Automatic Reminders
To activate background notifications and reminders, register the automation script into your system cron file:
# Run the reminder dispatcher script at the 5th minute of every hour
5 * * * * /usr/bin/python3 ~/.openclaw/skills/task-planner/scripts/send_reminders.py
Task Planner Data Schema & Taxonomy
Export Calendar Document Specification
When triggering document export utilities like export_doc --range week/month, the skill writes formatted document metrics to your local home directory.
| Property | Description | Path / Output |
|---|---|---|
| Default Destination | Path to the compiled markdown schedule | ~/openclaw_calendar.md |
| Default Range | Default window size if not specified | week (Options: week, month) |
| Formatting Specification | Presentation standard | Clean Markdown tables optimized for PDF translation |
Task Parameter Metadata
The table below outlines the attributes logged for each task record managed by the skill:
| Attribute | Type | Description | Values / Examples |
|---|---|---|---|
Title |
String | Primary summary of the action item | "Review backend API docs" |
Deadline |
Datetime | Exact target date and time | YYYY-MM-DD HH:MM:SS |
Reminder Offset |
String | Lead time before the deadline to send warnings | 15m, 1h, 1d |
Category |
String | Categorization tag for organization | "work", "personal", "health" |
Priority |
Enum | Urgency hierarchy of the task | high, medium, low |
Recurrence |
String | Rules governing recurring tasks | daily, weekly, monthly, yearly |
Task Planner Advanced Features
- Lazy Recurrence Scheduling: Prevents database bloat by dynamically calculating and scheduling only the single next occurrence once the current task instance is verified complete.
- Automated Cron Reminder Dispatch: Integrated scheduling mechanisms trigger high-frequency reminders without keeping persistent resource-heavy processes running in the background.
- OpenAI Whisper Integration: Transcribes WeChat and other external audio uploads directly into readable commands, enabling true hands-free productivity.
- Semantic Match Updating: Modifies or cancels plans using relaxed natural language references instead of rigid database keys or ID hashes.
SKILL.md
Loading
Related Openclaw Skills
Ten Women Who Changed Science and the World
An executable toolkit that leverages AI agents to extract powerful lessons, scientific discoveries, and resilience strategies from ten pioneering female scientists.
The Advice Trap AI Coaching Skill
An executable AI coaching toolkit based on Michael Bungay Stanier's book to help leaders tame their Advice Monster and build psychological safety.
Recipe Manager
A specialized recipe and ingredient database skill designed to record ingredient weights, track multiple versions, calculate precise single-portion costs, and export commercial recipes to spreadsheet formats.
MoltTwit Social Skill
An AI-first social media skill that enables agents to post updates, upload media, interact with users, and monitor notifications on MoltTwit via the Mastodon API.
Richard Nixon Biography & Leadership Toolkit
An executable strategic toolkit for AI agents to extract leadership, resilience, and cautionary lessons from the legendary rise and fall of Richard Nixon.
Pre-flight Dashboard Audit
A universal React dashboard audit skill designed to detect hardcoded values, tier bypasses, stale components, and onboarding inconsistencies before production release.
Featured*
