cron-scheduler 是一个定时任务调度管理技能,核心用途是定义、校验并注册稳定的 cron 作业,避免任务互相碰撞,并在用户休息时段控制通知与投递。
主要能力:调度错峰,每个 5 分钟槽位最多 1 个作业(可用槽位 :05 至 :50),检测到冲突时建议下一个可用槽位;静默时段门控,默认本地时间 23:00 至次日 8:00,若用户处于活跃状态可覆盖暂停静默,静默期间输出进入待发队列,次日联系时释放积压;精简作业提示词,任务只写“Read skills/{name}/SKILL.md and run it.”,避免内联长提示;幂等性要求,同一作业运行两次结果一致,无重复页面或时间线条目,用检查点状态文件跟踪进度并支持断点续跑,创建输出前先检查已有结果。结果保存为 reports/{job-name}/{YYYY-MM-DD-HHMM}.md。
使用方式分几个阶段:定义作业的名称、cron 表达式、要运行的技能和超时;校验时间表是否与现有作业冲突;检查静默时段并处理覆盖;注册到宿主调度器,如 OpenClaw cron、Railway cron、crontab 或进程管理器,注册项应通过 Minions 执行而非 agentTurn。多源场景建议用一条合并的 cron 行,例如 */5 * * * * gbrain sync --all --parallel 4 --workers 4 --skip-failed,替代多个按源分列的行;受管大脑则需使用包含 gbrain sources refresh <id> 与 --no-pull、--hard-deadline 13m 的写法。
限制与注意:作业必须先在小规模 3-5 项上测试;不得把通知放进静默时段;不得让作业重复产生副作用;遇到 sync_in_progress、lock_busy、writer_coordinator_required 等错误应按相应提示处理,不添加 --skip-failed 等绕过手段。资料未提供计费、价格与具体平台支持范围等信息。