Setup & Installation
openclaw skills install @jacobthejacobs/task-scheduler
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install task-scheduler
What This Skill Does
Schedules shell commands, agent tasks, API health checks, and file operations using natural language or cron syntax. Supports one-shot and recurring jobs. Parses time expressions like "in 5 minutes", "every monday at 9am", or standard cron patterns.
Uses OpenClaw's built-in cron tools with no external dependencies, so there are no scheduler services to configure or credentials to manage.
When to use it
- Running npm test every weekday morning before standup
- Backing up a database every Sunday night automatically
- Polling an API health endpoint every 30 minutes
- Generating a weekly sales report every Monday at 9am
- Cleaning temp files daily at 3am without manual intervention
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: /schedule check https://api.example.com/health every 30m
AGENT
- 1Classifies task as API health check based on URL and 'check' keyword
- 2Parses recurrence as every 30 minutes, converting to everyMs: 1800000
- 3Detects delivery channel from current session context
- 4Calls cron.add with kind: 'every', everyMs: 1800000, and payload targeting the URL
- 5Confirms scheduling and returns jobId to user
OUTPUT
Task scheduled. Runs every 30 minutes, fetches URL and reports HTTP status to current channel. Job ID returned for cancellation.