Schedule tasks
Make your agent run tasks on a schedule and send you the results.
Your agent can run a task on a timer. For example, it can send you a news digest every morning or check a website every hour. Scheduled tasks run on the VPS, so your computer can be off.
Add a task
officeclaws cron add \
--name morning-digest \
--schedule "0 9 * * 1-5" \
--timezone Europe/Berlin \
--message "Give me a 5-bullet summary of today's top tech news."| Flag | Required | Meaning |
|---|---|---|
--name | yes | A short name for the task |
--schedule | yes | When to run, in cron format |
--message | yes | What the agent should do each time. Write it like a chat message. |
--timezone | no | An IANA time zone such as Europe/Berlin or America/New_York. The default is UTC. |
--channel | no | Where to send the result: chat (default) or telegram |
--target | no | For telegram: your Telegram user ID (see below) |
Send results to Telegram
First connect Telegram. Then use your USER-ID from the pairing step as the target:
officeclaws cron add \
--name morning-digest \
--schedule "0 9 * * *" \
--timezone Europe/Berlin \
--message "Weather and top 3 news for today." \
--channel telegram \
--target 123456789List and remove tasks
officeclaws cron listNAME SCHEDULE TZ CHANNEL ENABLED NEXT
morning-digest 0 9 * * 1-5 Europe/Berlin telegram true 2026-10-20T09:00:00+02:00
officeclaws cron rm morning-digestSchedule format
A schedule has five fields: minute hour day-of-month month day-of-week.
| Schedule | Runs |
|---|---|
0 9 * * * | Every day at 09:00 |
0 9 * * 1-5 | Weekdays at 09:00 |
*/30 * * * * | Every 30 minutes |
0 */4 * * * | Every 4 hours |
0 18 * * 5 | Fridays at 18:00 |
0 8 1 * * | The 1st of every month at 08:00 |
Each scheduled run uses your ChatGPT limits. Very frequent tasks, such as every minute, use them up quickly.