OpenClaw 定时任务实战：cron表达式配置完整指南

为什么 OpenClaw 的 cron 是你最被低估的功能

大多数人安装 OpenClaw 后，只会用它做聊天问答。但真正让 OpenClaw 从"玩具"变成"生产力工具"的，是它的定时任务（cron）能力。本文基于我过去 3 个月在真实项目中跑 cron 的踩坑经验，讲清楚那些官方文档里没写的细节。

一、cron 表达式：不只是一串星号

OpenClaw 的 cron 语法沿用了标准 UNIX cron，但加入了时区（timezone）和会话模式（session）两个关键参数。很多人卡在这里。

openclaw cron add \
  --name "morning-briefing" \
  --cron "0 8 * * 1-5" \
  --timezone "Asia/Shanghai" \
  --session isolated \
  --message "请总结昨天的邮件，列出今日优先级前3的事项"

上面这个例子，工作日每天早上 8 点整，OpenClaw 会在一个隔离会话里执行任务，不会污染你的主聊天历史。

二、三个实战案例（都是我真实在用的）

案例1：每小时自动监控服务器 CPU

• 场景：我有台阿里云 ECS，偶尔 CPU 飙高，想让 OpenClaw 每小时检查一次
• 配置：0 * * * *（每小时整点执行）
• message 内容：让 Agent 通过 SSH tool 执行 top -bn1 | head -20，如果 CPU > 80% 就发钉钉告警
• 效果：连续跑了 6 周，成功捕获了 2 次异常，比云监控告警还快

案例2：每天17:30自动生成工作日报

• 场景：不想每天手动写日报，让 OpenClaw 自己整理
• 配置：30 17 * * 1-5
• 关键技巧：在 message 里明确指定信息来源（"读取今天的工作区文件 memory/ 目录"），否则 Agent 会瞎编

案例3：每周一早上推送本周技术资讯

• 配置：0 9 * * 1
• message：让 Agent 调用搜索工具，抓取"本周 AI 热点"，整理成 5 条摘要推送到微信
• 注意：这个任务依赖联网搜索，需确保 OpenClaw 的搜索 tool 已启用

三、session 参数的坑：isolated vs main

session 模式	适用场景	缺点
isolated	定时任务、自动化脚本	无法访问主会话的上下文
main	需要引用聊天历史的任务	会污染主会话的记录

我的建议：95% 的 cron 任务用 isolated，只有需要"接着上次对话继续"的任务才用 main。

四、常见错误排查

• cron 任务创建了但不执行：检查 Gateway 是否在运行（openclaw gateway status），cron 依赖 Gateway 进程
• 时区不对：务必显式指定 --timezone "Asia/Shanghai"，默认是 UTC，差 8 小时
• 任务执行了但没输出：isolated 会话的输出不会自动推送，需要配置 --delivery 参数或者让 Agent 主动调用消息发送 tool
• cron 表达式写错：推荐用 crontab.guru 在线验证，比死记靠谱

五、进阶：用 cron + 内网穿透实现"手机随时触发任务"

这是一个稍微高级的用法。思路是：cron 任务定期轮询某个 Webhook，当你用手机访问那个 URL 时，触发 OpenClaw 执行指定任务。相当于给自己做了一个"私有 Siri 快捷指令"。

# 每分钟检查一次 Webhook（轻量轮询）
openclaw cron add \
  --name "webhook-listener" \
  --cron "* * * * *" \
  --timezone "Asia/Shanghai" \
  --session isolated \
  --message "检查 https://your-webhook.com/pending 是否有待处理任务，如果有则执行并清除标记"

这个方案的优点是：不需要服务器有固定公网 IP，cron 主动出站即可。

六、相关资源

• OpenClaw 官方文档：cron 命令完整参数说明（建议通读一遍）
• 如果你想把 cron 任务的结果推送到微信，可以参考 OpenClaw 接入微信完整教程
• 服务器部署相关：Windows 部署 OpenClaw 完整指南

总结

OpenClaw 的 cron 功能让 Agent 从"你问它答"变成"它主动帮你干活"。核心要点：选对 session 模式、时区别忘记配置、任务逻辑要让 Agent 有明确的可执行指令。花 10 分钟配置好第一个 cron 任务，后面的时间都是净赚的。