Cron 定时任务可靠性指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-ez-cronjob。
技能介绍
先厘清你在排什么
在 Clawdbot/Moltbot 里做定时消息,常见症状并不像「cron 表达式写错了」那么单纯:任务状态是 ok 却收不到消息、定时点整体偏几个小时、cron list/cron add 一调就 10 秒超时,或者 fallback 模型突然去调 exec/read 等不该用的工具。这份技能把生产排障里反复出现的模式整理成可对照的清单,而不是泛泛讲 Linux crontab。
技能覆盖的核心能力与步骤
文档强调一条 Golden Rule:可靠投递要把 --session isolated、--tz "TIMEZONE"、--deliver、--best-effort-deliver 组合起来用。针对五类高频问题给出了成因与改法:
- 内部 cron 工具死锁:Agent 直连 cron 工具会与 gateway 互相卡住;应通过
exec/bash跑clawdbot cron子命令,而不是调用内置 cron tool。 - 消息未送达:
--session main或--system-event在主线会话有对话时容易丢消息;固定用--session isolated,并用clawdbot cron run做创建后验证。 - 执行时间不对:缺省时区会落到 UTC;需显式
--tz,并附常见America/New_York、Asia/Tokyo等 ID 表。 - Fallback 不听话:在消息正文里嵌入
[INSTRUCTION: DO NOT USE ANY TOOLS]类约束,而不是只依赖系统提示。 - 长期处于 error:按配额、chat ID、群组权限、gateway 状态逐项排查,必要时
gateway restart或cron rm后重建。
后半段还整理了 Debugging Commands、三条完整示例(工作日站会、一次性提醒、周报)以及新建任务的 Checklist,便于对照自检。
适用边界与注意点
内容紧扣 Clawdbot/Moltbot 的 clawdbot cron 体系 与 Telegram/WhatsApp 等 channel 投递,不替代通用系统级 cron 或任意调度平台文档。若你的环境没有 gateway、channel ID 未校验,或仍坚持让 Agent 直接调 cron tool,这份指南里的解法可能只对了一半。
使用场景
- Telegram/WhatsApp 定时提醒在测试能发、上线按表触发却经常收不到,需要按会话隔离与 deliver 参数逐项核对
- Agent 帮用户添加定时任务时一调 cron 工具就报 Tool execution timed out,需要改用 exec 执行 clawdbot cron 命令
- 周一到周五早上 9 点站会提醒实际比预期早或晚数小时,需要为任务显式设置 Asia/Shanghai 等时区
- 主模型下线后 fallback 在定时消息里乱调工具,需要在消息模板里写入禁止用工具的指令
适合人员
- 负责 Clawdbot/Moltbot 机器人上线与值守的运维,需要把定时消息失败从偶发变成可复现、可修复
- 在对话里让 Agent 代管 cron 的集成开发者,需要避免内置 cron tool 死锁并走 CLI 路径
- 维护多时区用户群的通知机器人管理员,需要校准时区 ID 与 channel/to 目标
- 排障 gateway 延迟与任务 error 状态的平台维护者,需要对照日志与 checklist 做分层诊断