🤖 定时任务创建专家
声明：本工具依赖 openclaw CLI 执行任务。在执行命令前，你可能需要通过上下文或 read 工具获取 user_id/chat_id 以及 openclaw.json 中的多 Agent 配置 (channels.feishu.accounts)。这些信息是配置飞书定时任务中的必要参数，否则任务不能触发。如果你发现自己当前没有权限读取这些信息，或者上下文中缺失这些信息，请务必先向用户询问补全，绝不可自行编造。
🎯 应用场景与触发条件
当用户表达出需要在未来某个时间点或按照特定周期进行提醒、执行任务时触发。
- 典型触发语：“5分钟后提醒我做xxx”、“每天8点提醒我xxx”、“工作日每两个小时提醒我喝水”等。
🛑 核心铁律
- 唯一创建方式：必须使用 CLI 指令
openclaw cron add创建任务。 - 禁止直接手写：创建时严禁直接修改
cron/jobs.json（仅在修改/更新已有任务时允许）。 - 禁用系统功能：严禁使用系统默认
crontab，严禁使用延时脚本 (sleep等) 触发任务。
⚙️ 执行逻辑与参数拆解
在生成命令前，必须严格按照以下四个步骤收集并处理参数：
步骤 1：信息内容拆解
- 提取诉求
{message}：整理用户的具体需求。- 如果任务很简单，则提取一句话作为 message。
- 如果用户的诉求比较明确且清晰，就直接将用户的指令作为 message，换行符用
\n代替。 - 如果任务较为复杂，需将其拆分为多个步骤（1、2、3...），然后合并为一段话，换行符必须使用
\n代替。
- 生成名称
{cron_name}：提取简短、有代表性的纯英文/拼音名称。
步骤 2：时间规则拆解
判断任务是“一次性任务”还是“周期性任务”，默认用户所指时间均为 东八区 (Asia/Shanghai)。
-
A. 一次性任务
- 必须计算出目标执行的精确时间，并将其转换为 UTC 标准时间。
- 格式必须为
YYYY-MM-DDThh:mm:ssZ（例如北京时间 2026-02-02 00:00:00，应转换为2026-02-01T16:00:00Z）。 - 使用参数：
--at "<UTC时间>"和--delete-after-run（执行后即删除）。
-
B. 周期性任务
- 需根据需求生成标准的 5 位 Cron 表达式
{cron_expression}。- Cron 规则参考：
* * * * *(分 时 日 月 星期)。例如：每天早上8点为0 8 * * *，工作日每两小时为0 */2 * * 1-5。
- Cron 规则参考：
- 必须指定时区参数，如果用户没有指定时区则为东八区：
--tz "Asia/Shanghai"。 - 必须 添加防并发打散参数：
--stagger（随机设置30s到5m之间的值，如30s,1m,2m等）。 - 使用参数：
--cron "<Cron表达式>"。
- 需根据需求生成标准的 5 位 Cron 表达式
步骤 3：发送目标与渠道拆解
分析指令的来源环境，确定消息发送的渠道参数：
- 一、判断来源：
分析指令的触发环境，必须完整明确以下三个维度的信息：
- 渠道归属：来自后台 Terminal 还是飞书等 IM 渠道？
- 对话类型（若为飞书）：当前是 私聊 还是 群聊？
- 部署模式（若为飞书）：当前系统是 单 Agent 还是 多 Agent 配置？
- 二、如果指令来源于飞书，必须完成以下两项数据提取：
- 获取目标 ID：
- 私聊场景 -> 提取当前对话中用户的
user_id（必须以ou_开头）。 - 群聊场景 -> 提取当前群聊对应的
chat_id（必须以oc_开头）。
- 私聊场景 -> 提取当前对话中用户的
- 判定 Agent 模式：
- 读取
openclaw.json文件。 - 检查
channels.feishu下是否存在accounts字段：有则为多 Agent，无则为单 Agent。
- 读取
- 获取目标 ID：
- 三、如果为后台触发或者非飞书 IM 渠道按其对应默认规则处理。
根据上述判断，生成对应的目标参数集：
- 情形 A：后台触发
- 参数：
--announce
- 参数：
- 情形 B：飞书单 Agent 私聊
- 参数：
--announce --channel feishu --to "{user_id}"
- 参数：
- 情形 C：飞书单 Agent 群聊
- 参数：
--announce --channel feishu --to "{chat_id}"
- 参数：
- 情形 D：飞书多 Agent 私聊
- 参数：
--announce --channel feishu --to "user:{user_id}" --account "{account}"(注意：此处的 to 参数必须加上user:前缀)
- 参数：
- 情形 E：飞书多 Agent 群聊
- 参数：
--announce --channel feishu --to "chat:{chat_id}" --account "{account}"(注意：此处的 to 参数必须加上chat:前缀)
- 参数：
步骤 4：基础运行时配置
所有任务必须附带以下基础运行参数：
--session isolated（绝对不能选择 main）--wake now
🛠️ 指令合成与示例
综合以上 4 个步骤，最终生成的指令结构如下（请根据实际情况组合参数）：
示例 1：一次性任务（飞书多 Agent 环境群聊）
场景：用户在飞书（多Agent环境，account为assistant）要求“明早8点提醒我开早会”。
openclaw cron add \
--name "morning_meeting_reminder" \
--at "2026-03-01T00:00:00Z" \
--session isolated \
--message "记得参加早会哦！" \
--wake now \
--delete-after-run \
--announce \
--channel feishu \
--to "chat:oc_1a2b3c4d5e6f" \
--account "assistant"
示例 2：周期性任务（飞书单 Agent 环境私聊）
场景：用户在飞书要求“每天晚上10点提醒我写日报”。
openclaw cron add \
--name "daily_report" \
--cron "0 22 * * *" \
--stagger 2m \
--tz "Asia/Shanghai" \
--session isolated \
--message "该写日报啦！\n1. 总结今日进度\n2. 规划明日目标\n3. 归纳并调用 message 工具发送给用户" \
--wake now \
--announce \
--channel feishu \
--to "ou_9z8y7x6w5v4u"
示例 3：周期性任务（后台触发）
场景：系统管理员在后台要求“每 2 个小时检查一次系统日志”。
openclaw cron add \
--name "check_system_logs" \
--cron "0 */2 * * *" \
--stagger 30s \
--tz "Asia/Shanghai" \
--session isolated \
--message "请执行系统日志常规检查。" \
--wake now \
--announce