Scheduling Recurring Jobs

OpenClaw runs scheduled tasks through the Gateway using cron jobs.

Create a job

Use openclaw cron add to schedule a recurring task:

openclaw cron add --name morning-briefing --schedule "0 9 * * *" --prompt "Summarize the news"

The --schedule flag accepts standard cron expressions (minute hour day month weekday).

Manage jobs

• openclaw cron list — see all scheduled jobs
• openclaw cron edit <id> — modify a job
• openclaw cron remove <id> — delete a job

Test immediately

Use openclaw cron run <id> to trigger a job right away without waiting for its schedule. This is useful for verifying the prompt and delivery channel work.

Tips

• Use exact cron expressions with local wall-clock time.
• Test each job with cron run after creating it.
• Keep job names descriptive so they are easy to identify in cron list.