scheduled_task

Schedule cron or interval tasks for agent wake-ups, messages, and Lua scripts.

2.0k|410|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/espressif/esp-claw --skill scheduled-task-espressif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scheduled_task
Source: https://github.com/espressif/esp-claw/tree/main/application/edge_agent/fatfs_image/skills/scheduled_task
Command: npx skills add https://github.com/espressif/esp-claw --skill scheduled-task-espressif

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Users need reliable timer-based automation on their IoT device, but writing and wiring scheduler logic is inconvenient and error-prone.

Core Features & Use Cases

  • Cron or interval scheduling: Set wall-clock schedules (cron) or relative periodic triggers (interval in milliseconds).
  • Multiple execution modes: Wake the agent to run an IM-driven loop, send a fixed IM reminder, or run a scheduled Lua script.
  • Controlled triggering: Limit how many times the task fires using trigger_count (with 0 meaning unlimited).
  • Router integration: For message-based modes it routes via the IM event so the existing agent/chat handling can execute with the right context.
  • Use Case: Create a daily 17:06 hydration reminder message or wake the agent at a specific time to check weather and recommend an outfit.

Quick Start

Ask the agent to add a cron scheduled task that sends a fixed Feishu message every day at 17:06 with trigger_count set to 0 for unlimited repeats.

Frequently Asked Questions about scheduled_task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule cron jobs or interval timers for IoT automation?

You can schedule cron jobs or interval timers for IoT automation by configuring a task with a stable task_id, selecting either a wall-clock cron expression or a millisecond-based interval, and setting an execution mode to trigger actions automatically.

Can I send scheduled chat reminders using cron on my device?

Yes, you can send scheduled chat reminders by setting the execution mode to send_message, which routes via the IM event to deliver fixed chat notifications at specified wall-clock times.

What's the best way to run a Lua script periodically on IoT hardware?

The best way to run a Lua script periodically is to select the run_script execution mode, which executes a bundled Lua script that registers scheduler entries and applies router rules automatically.

Does IoT scheduling support limiting the number of times a task fires?

Yes, IoT scheduling supports limiting task executions by mapping the trigger_count parameter to scheduler max_runs, where setting trigger_count to 0 allows unlimited repetitions.

How does router rule creation work for message-based scheduled tasks?

For message-based scheduled tasks, router rule creation routes triggers via the IM event so existing agent or chat handling executes with the right context, featuring robust error reporting and rollback behavior.

Why do scheduled agent wake-ups require a stable task_id?

Scheduled agent wake-ups require a stable task_id to ensure reliable tracking and execution of cron or interval triggers across the agent runtime without losing task references.