Schedule reminders and recurring agent tasks at specific times or intervals. Use it for meeting alerts, regular reports, or weekday routines, with support for one-time tasks, time zones, and viewing or removing scheduled jobs.
Schedule reminders and recurring tasks.
Review the instructions the agent will receive before you install.
Use the cron tool to schedule reminders or recurring tasks. New tasks run in the current chat. nanobot sends the agent's final reply to that chat. The user can change the task's chat in WebUI.
Write what to do in message. For a normal reminder or report, do not copy the current channel, chat ID, or instructions to call the message tool into the task. For example, use "Remind me to drink water", not "Call message to send to this chat".
If the user asks to send to other chats, preserve those recipients in the task instructions. Use the message tool for those sends and for file attachments. Existing tasks that explicitly request a message call still use it; changing the task's chat does not change explicit recipients in its instructions.
Choose by timing and notification behavior, not repetition. A specified time or interval uses cron, even when it repeats: "every day at 8am, remind me to drink water" is a cron task. Use HEARTBEAT.md for background checks with flexible timing that should notify only on actionable changes. Heartbeat does not guarantee a requested time or interval; do not substitute it for an explicit schedule.
Fixed reminder:
cron(action="add", message="Time to take a break!", every_seconds=1200)
Dynamic task (agent executes each time):
cron(action="add", message="Check HKUDS/nanobot GitHub stars and report", every_seconds=600)
One-time scheduled task (compute ISO datetime from current time):
cron(action="add", message="Remind me about the meeting", at="<ISO datetime>")
Timezone-aware cron:
cron(action="add", message="Morning standup", cron_expr="0 9 * * 1-5", tz="America/Vancouver")
List/remove:
cron(action="list")
cron(action="remove", job_id="abc123")
| User says | Parameters |
|---|---|
| every 20 minutes | every_seconds: 1200 |
| every hour | every_seconds: 3600 |
| every day at 8am | cron_expr: "0 8 * * *" |
| weekdays at 5pm | cron_expr: "0 17 * * 1-5" |
| 9am Vancouver time daily | cron_expr: "0 9 * * *", tz: "America/Vancouver" |
| at a specific time | at: ISO datetime string (compute from current time) |
Use tz with cron_expr to schedule in a specific IANA timezone. Without tz, the server's local timezone is used.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Find agent skills on ClawHub, a public skill registry, using everyday language. Install selected skills into the nanobot workspace, review installed skills, and update them together through command-line tools.
Use the GitHub command-line tool to inspect issues, pull requests, and automated workflow runs. Check failed steps and logs, retrieve additional details through the API, and extract selected fields into structured results.
Generate images from written instructions and edit saved or uploaded images using them as references. Continue refining the latest image in a conversation, adjusting details such as brightness, background, or colors while specifying what to preserve.
Search the agent’s conversation history by topic or date to retrieve relevant past entries. Inspect neighboring records when needed to understand the surrounding discussion, using the history log specified for the agent’s workspace.
Inspect an agent’s current model, processing limits, workspace, tools, and message routing details. Diagnose unavailable capabilities, adjust permitted runtime settings, or keep temporary session notes, with advance notice before changes that affect the model or limits.
Get answers about nanobot setup, configuration, and troubleshooting using documentation bundled with the installed version. Find relevant guidance for the WebUI, model providers, integrations, and configuration fields.