Back to skills
extension
Category: OtherNo API key required

feishu-cron-reminder

在飞书机器人上创建和管理定时提醒任务。支持一次性提醒和循环提醒,自动发送消息到飞书用户或群组。当用户提到"飞书定时提醒"、"飞书定时任务"、"飞书 cron"、"飞书提醒"时激活。

personAuthor: zzqsama066hubclawhub

feishu-cron-reminder:飞书定时提醒

在 OpenClaw 中创建定时任务,自动将提醒消息推送到飞书。

前置要求

  1. OpenClaw 已配置飞书机器人
  2. 飞书机器人已添加到目标用户/群组

使用方法

用户只需说「提醒我明天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

  • 用户 IDuser:ou_XXXXXXXXXXXXXXXX(以 ou_ 开头)
  • 群组 IDchannel: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 工具。