Cron 定时任务 — 让 Sophclaw 到点自动执行

Cron 是什么

Cron 是 OpenClaw 内置的定时调度功能——你可以让 Sophclaw 在指定时间自动执行某个任务，不需要手动触发。结合渠道接入（飞书/钉钉），执行结果会自动推送到你指定的会话里。

典型场景

Cron 最适合以下几类"定期要做"的事：

• 每天晚上 11 点提醒吃药 / 健身 / 看某个视频
• 每天早上 9 点抓取几个网站的热点生成简报，推送到飞书群
• 每周一早上 10 点自动读取上周的销售数据生成周报
• 每小时检查一次某个 API 是否正常，异常时报警
• 每天凌晨自动备份重要目录到网盘

创建定时任务（对话方式）

在对话里直接用自然语言说：

"利用 Cron 功能，通过飞书 channel，创建定时任务，通过会话 ID xxxxxxxxxx 提醒我每天 23:10 都要吃药！"

Sophclaw 会自动：

1. 解析你的需求，理解频率（每天 23:10）、内容（吃药提醒）、推送渠道（飞书）和会话 ID
2. 把这条定时任务写入 Cron 配置
3. 返回创建结果

会话 ID 在哪里

推送目标需要指定会话 ID——飞书里获取方式：

1. 打开飞书客户端
2. 点击要发送提醒的会话（可以是自己和机器人的私聊，也可以是某个群）
3. 点击右上角"···"
4. 进入设置界面，底部能看到会话 ID

检查任务是否创建成功

创建后建议确认一下：

1. 在 Sophclaw 的智能体定时任务界面查看，刚才创建的任务是否出现
2. 确认最后一行是会话 ID（下图光亮标记部分）——如果缺少会话 ID，说明任务没创建成功，需要重新引导

如果缺少会话 ID，Sophclaw 会在对话里提示，你可以补充完整后重新创建。

飞书客户端接收提醒

创建成功后，到点时飞书客户端会收到提醒：

一个更复杂的例子

"通过 Cron 创建定时任务：每天早上 9 点，抓取 techcrunch.com 首页的科技新闻标题，取前 5 条，生成一个 Markdown 简报，推送到飞书群会话 ID xxxxxxxxxx"

这条任务包含了：定时（每天 9:00）+ 网页抓取（techcrunch.com）+ 信息提取（前 5 条标题）+ 格式化（Markdown）+ 推送（飞书群）。整条链路 Cron 到点自动触发，完全不需要人干预。

Cron 格式速查

Cron 表达式的标准格式是：分 时 日 月 周，比如：

不过在对话方式下，你不需要写 Cron 表达式——直接用自然语言描述频率即可（"每天早上 9 点""每周一早上"）。

注意事项

1. 渠道的 connectionMode：Cron 定时任务需要 HTTP 模式（不像即时消息只需 WebSocket）。如果你接了飞书机器人，记得把 connectionMode 从 websocket 改成 dual（同时开启 WebSocket 和 HTTP）。
2. Sophclaw 必须在线：Cron 是 Sophclaw 运行时执行的——如果 Sophclaw 关了或重启了（比如电脑休眠），定时任务不会执行。长期运行建议跑在一台常开的服务器或 PC 上。
3. 先在小任务上试：创建重要的定时任务前，先用一个简单的测试任务（比如"每天 1 分钟后给我发一条测试消息"）确认 Cron 正常工作。