feishu-cron-reminder：飞书定时提醒
在 OpenClaw 中创建定时任务，自动将提醒消息推送到飞书。
前置要求
- OpenClaw 已配置飞书机器人
- 飞书机器人已添加到目标用户/群组
使用方法
用户只需说「提醒我明天9点开会」，AI 自动解析并创建 cron 任务。
支持的提醒类型
| 类型 | 示例 | 说明 |
|---|
| 一次性 | "提醒我明天9点开会" | 到指定时间发一次 |
| 每日循环 | "每天早上8点提醒我" | 每天固定时间 |
| 工作日循环 | "每个工作日18点提醒下班" | 周一到周五 |
| 每周循环 | "每周一9点提醒周会" | 每周固定星期 |
命令模板
一次性提醒（at 定时）
openclaw cron add \
--name "我的提醒" \
--at "2026-04-08T09:00:00.000Z" \
--tz "Asia/Shanghai" \
--session isolated \
--message "直接发送以下文字到飞书，不需要调用任何工具：开会时间到了！" \
--timeout-seconds 180 \
--delete-after-run \
--announce \
--channel feishu \
--to user:ou_XXXXXXXXXXXXXXXX \
--description "一次性提醒示例"
每日循环提醒
openclaw cron add \
--name "每日早提醒" \
--cron "0 8 * * *" \
--tz "Asia/Shanghai" \
--session isolated \
--message "直接发送以下文字到飞书，不需要调用任何工具：早安，今天也要加油！" \
--timeout-seconds 180 \
--announce \
--channel feishu \
--to user:ou_XXXXXXXXXXXXXXXX \
--description "每日提醒"
工作日提醒
openclaw cron add \
--name "工作日下班提醒" \
--cron "0 18 * * 1-5" \
--tz "Asia/Shanghai" \
--session isolated \
--message "直接发送以下文字到飞书，不需要调用任何工具：下班时间到，记得整理桌面！" \
--timeout-seconds 180 \
--announce \
--channel feishu \
--to user:ou_XXXXXXXXXXXXXXXX \
--description "工作日下班提醒"
发送到群组
将 --to 参数改为群组 ID：
--to channel:oc_XXXXXXXXXXXXXXXX
cron 表达式参考
| 表达式 | 含义 |
|---|
0 8 * * * | 每天 08:00 |
0 9 * * 1-5 | 工作日 09:00 |
30 18 * * 1-5 | 工作日 18:30 |
0 9 * * 1 | 每周一 09:00 |
0 20 * * * | 每天 20:00 |
关键参数说明
| 参数 | 必须 | 说明 |
|---|
--name | 是 | 任务名称 |
--cron | 与--at二选一 | cron 表达式 |
--at | 与--cron二选一 | ISO 绝对时间（UTC） |
--tz | 是 | 写 Asia/Shanghai |
--session | 是 | 写 isolated |
--message | 是 | 要发送的文字内容 |
--timeout-seconds | 是 | 最小 180，建议 180 |
--delete-after-run | 一次性任务必填 | 完成后自动删除 |
--announce | 是 | 启用结果投递 |
--channel feishu | 是 | 投递到飞书 |
--to | 是 | 目标 ID（见下方） |
飞书目标 ID
- 用户 ID：
user:ou_XXXXXXXXXXXXXXXX（以 ou_ 开头）
- 群组 ID：
channel:oc_XXXXXXXXXXXXXXXX（以 oc_ 开头）
获取方法：在飞书开发者后台查看机器人的 openId 或群 ID。
时区注意事项
--at "2026-04-08T09:00:00.000Z" 是 UTC 时间，不是北京时间。
换算：北京时间 = UTC + 8 小时
- 北京时间 09:00 = UTC 01:00 →
--at "2026-04-08T01:00:00.000Z"
建议：用 --cron + --tz Asia/Shanghai 代替 --at，自动处理时区。
常见错误排查
| 症状 | 原因 | 解决方法 |
|---|
| 消息没发出去 | --to ID 格式错误 | 必须是 user:ou_ 或 channel:oc_ 开头 |
| 任务不触发 | --at 时间在过去 | 确认时间是未来，用 ISO 绝对时间 |
| 超时无响应 | --timeout-seconds 太小 | 设为 180，不要低于 120 |
| 飞书收不到 | 没有飞书机器人 | 确认 OpenClaw 飞书配置正确 |
架构说明
本 Skill 调用 OpenClaw 内置的 openclaw cron 命令创建定时任务，消息通过 OpenClaw 的 announce 机制投递到飞书频道，不需要额外的 feishu_chat 工具。
