例行任务的计划
直接用平常的话告诉机器人,例如:
每月 1 号上午 9 点准备一份报告,按北京时间。
机器人会把时间要求转换成 cron 表达式,WenwoBot 负责校验。更改立即生效;卡片会显示规则、时区和接下来的三次运行时间,并提供编辑、暂停和撤销。到点时由调度器唤醒机器人,后台不会一直运行模型去查日期。
例行任务还可以设置 检查项(日历、邮件、其他例行任务的运行结果):这些检查在每次触发时、任何 AI 对话之前以普通代码运行,所以没有新情况的触发不花任何费用。见 主动例行任务。
在 自动化 → 计划 中,可以在例行任务编辑器里选择 每月、每年 或 自订 cron(高级)。「每月」可以选 1–31 日或 最后一天。新建时时区默认为你浏览器的时区,可以修改。已保存的 cron 例行任务会保留自己的时区,即使换到另一台电脑也一样。只修改标题或指令不会改变计划。
关闭、开启与已完成
自动化 页面上的开关可以暂停或恢复一个计划或 Webhook;计划恢复后会显示它的下一次运行时间。服务器拒绝时,原因会显示在开关旁边。时间已过的一次性计划显示为 已完成,没有开关;为它保存一个新时间就会重新开启。
删除机器人会一并删除它的计划、Webhook 和运行记录,Webhook 地址会立即失效。
高级 cron
cron 有五个字段:分钟 小时 日 月 星期。必须指定一个明确的 IANA 时区,例如 Asia/Shanghai、America/New_York 或 UTC。示例:
| 时间 | 表达式 |
|---|---|
| 每月 1 日 09:00 | 0 9 1 * * |
| 每月最后一天 09:00 | 0 9 L * * |
| 每月第二个星期一 09:00 | 0 9 * * MON#2 |
| 每年 1 月 1 日 09:00 | 0 9 1 1 * |
| 工作日 09:00 和 17:00 | 0 9,17 * * MON-FRI |
| 工作日工作时间内每 15 分钟 | */15 9-16 * * MON-FRI |
列表、范围、步长以及 L、W、# 都受支持。和标准 cron 一样,同时限制「日」和「星期」时,任一 字段匹配即可运行;如果只想按其中一个,另一个请保留 *。不支持秒、年份字段、@reboot 之类的宏、shell 命令或任意代码,最小精度为一分钟。
像「每 90 分钟」这样按间隔重复的需求,请使用间隔计划:cron 描述的是日历上的位置,分钟字段里的 */90 并不表示每隔 90 分钟。节假日、外部事件或「收到付款之后」这类条件不是日历表达式,请改用事件或 Webhook。
日期、时钟变化与停机
- 不存在的日期会被跳过:31 日会跳过较短的月份,2 月 29 日只在闰年运行。最后一天 适用于每个月。
- 夏令时跳过的时段会顺延到跳过之后;重复的一小时内,匹配的时间只在第一次出现时运行。
- 例行任务默认使用 机器人当前的设置:它选择的模型和配置的电脑(包括自建 VPS)。
- WenwoBot 必须保持运行 才能派发例行任务,包括面向云端的任务。计划在你电脑上的应用里运行,没有外部的常驻调度服务,所以电脑睡眠或应用退出时什么都不会运行。桌面应用在接通电源时,会在任务到期前一小时内和运行期间阻止电脑空闲睡眠(自动化页面中的相应选项,默认开启;合上盖子仍会睡眠)。需要 7×24 小时运行时,请把 WenwoBot 部署在 VPS 上。
- 补跑规则:延迟 12 小时以内,可以补跑一次错过的运行;更早的会留下一条「错过运行」记录。同一个 cron 任务不会叠加重复的运行。
- 需要你批准或回答的运行会一直等你。卡片和例行任务日志会说明它在等什么,等待时间不计入运行时限。
- 无人值守的运行(计划、Webhook 或 立即运行)遇到临时故障会自动恢复:引擎卡住、WenwoBot 重启、服务商限流或短暂故障时,会在短暂等待后于同一对话中重试一次;第二次失败才算失败。