教程
定时任务自动化
使用 OpenClaw 的内置调度器安排任务和自动化工作流程。
⏰ 什么是定时任务？
OpenClaw 包含一个强大的内置调度器，用于自动化重复性任务。安排每日简报、定期检查或复杂的工作流程 - 全部自动触发。
- ✓基于时间的触发器 — 在特定时间或间隔运行任务
- ✓自然语言 — 使用 '每天早上9点' 或 cron 语法安排任务
- ✓完整 AI 访问 — 计划任务可以使用所有 OpenClaw 功能
- ✓执行模式 — 在主会话或隔离环境中运行
计划类型
at在特定时间运行
at HH:MM
at 09:00、at 14:30、at 00:00
every按固定间隔运行
every N minutes/hours/days
every 30 minutes、every 2 hours、every day at 9am
cron用于复杂计划的完整 cron 表达式
cron: * * * * *
0 9 * * 1-5（工作日早上9点）
执行模式
💬 主会话
任务在您的主 OpenClaw 会话中运行，具有完整的上下文和记忆访问权限。
- +访问对话历史
- +共享记忆和上下文
- +可以引用之前的任务
- -可能中断活动对话
- -共享速率限制
🔒 隔离模式
任务在单独的沙盒环境中运行，有自己的记忆。
- +不干扰主会话
- +干净的执行环境
- +更适合敏感任务
- -无法访问主会话历史
- -单独的记忆空间
CLI 示例
简单提醒
安排每日提醒：
$
openclaw cron add --name "Check calendar" --at "20m" --session main --wake now这会创建一个每天早上9:00运行的任务。
每日简报
获取包含天气、日历和新闻的早间简报：
$
openclaw cron add --name "Morning status" --cron "0 7 * * *" --tz "America/Los_Angeles" --session isolated --message "Summarize inbox" --deliver --channel whatsapp --to "+1555..."AI 将收集信息并发送格式化的简报。
定期检查
每30分钟检查一次：
$
openclaw cron add --name "Health check" --every 300000 --session isolated --message "Check system status"从创建任务时开始，每30分钟运行一次。
Cron 语法参考
五字段格式
* * * * *
分钟小时日期月份星期
| 字段 | 范围 | 示例 |
|---|---|---|
| 分钟 | 0-59 | 0、30、*/15 |
| 小时 | 0-23 | 9、14、*/2 |
| 日期 | 1-31 | 1、15、*/7 |
| 月份 | 1-12 | 1、6、*/3 |
| 星期 | 0-6（周日=0） | 1-5、0,6 |
常用模式
| 模式 | 描述 |
|---|---|
| 0 9 * * * | 每天早上9:00 |
| 0 9 * * 1-5 | 工作日早上9:00 |
| */30 * * * * | 每30分钟 |
| 0 */2 * * * | 每2小时 |
| 0 9 1 * * | 每月1号早上9点 |
| 0 0 * * 0 | 每周日午夜 |
高级功能
条件执行
仅在满足特定条件时运行
openclaw cron add "every day at 9am" "如果今天是工作日，发送我的日历"
链式任务
按顺序运行多个任务
openclaw cron add "every monday at 9am" "1. 检查邮件 2. 总结重要邮件 3. 添加到待办列表"
带工具
在计划任务中使用特定工具
openclaw cron add "every hour" "检查 https://example.com 的变化" --tools browser
管理任务
1
列出所有任务
$
openclaw cron list显示所有计划任务及其 ID 和下次运行时间
2
删除任务
$
openclaw cron remove <job-id>通过 ID 删除计划任务
3
暂停/恢复
$
openclaw cron pause <job-id>$
openclaw cron resume <job-id>暂时禁用任务
4
查看历史
$
openclaw cron history查看过去的执行及其结果
任务存储
定时任务存储在本地，并在重启后保持。
任务：~/.openclaw/cron/jobs.json:
~/.openclaw/cron/jobs.json历史：~/.openclaw/cron/history.json:
~/.openclaw/cron/runs/OpenClaw 启动时会自动加载任务。
开始自动化！
设置您的第一个自动化任务，让 OpenClaw 为您工作。