commit bc95c2d7a6de2ced0f837059898eaeb95e92a292 Author: OpenClaw Bot Date: Fri Apr 3 16:06:52 2026 +0800 auto-sync: cron-schedule 2026-04-03_16:06 diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..22b1c1b --- /dev/null +++ b/SKILL.md @@ -0,0 +1,67 @@ +--- +name: cron-schedule +description: 定时任务/提醒设置，支持一次性定时提醒和周期性cron任务。激活当用户提到"提醒我"、"定时"、"cron任务"、"多久之后通知我"等相关需求时。 +--- + +# 定时任务设置Skill +用于快速创建定时提醒、周期性自动化任务。 + +## 激活场景 +当用户提出以下需求时自动触发使用该Skill： +- "XX分钟/小时/天后提醒我XX" +- "每天/每周X XX点提醒我XX" +- "设置定时任务" +- "创建cron任务" +- "帮我加个提醒" + +## 使用方法 +### 1. 一次性定时提醒（执行后自动删除） +**参数规则：** +- 延迟时间：支持两种写法： + - 相对时间：`+30m`、`+2h`、`+1d`（分别对应30分钟、2小时、1天） + - 绝对时间：ISO格式时间字符串，例如`2026-03-14T09:26:44+0800` +- 提醒内容：需要通知用户的具体消息，统一前缀为`⏰ ` +- 通知对象：支持基于飞书user_id发送，格式为`user:<用户user_id>`，用户user_id可从员工列表文档查询获取 + +**示例：** +用户需求："30分钟后提醒我开会" +执行命令： +```bash +openclaw cron add --at +30m --name "30分钟后开会提醒" --message "⏰ 提醒：时间到了，该去开会啦！" --announce --channel feishu --to user:<用户user_id> --tz Asia/Shanghai --delete-after-run +``` + +### 2. 周期性定时任务（重复执行） +**参数规则：** +- cron表达式：标准cron格式 `分 时 日 月 周`，例如`0 8 * * *`表示每天8点 +- 任务名称：便于识别的任务标识 +- 执行内容/提醒消息：需要执行的操作或通知内容，统一前缀为`⏰ ` +- 通知对象：支持基于飞书user_id发送，格式为`user:<用户user_id>`，用户user_id可从员工列表文档查询获取 + +**示例：** +用户需求："每天早上8点提醒我备份数据" +执行命令： +```bash +openclaw cron add --cron "0 8 * * *" --name "每日8点数据备份提醒" --message "⏰ 每日提醒：请执行当日数据备份操作~" --announce --channel feishu --to user:<用户user_id> --tz Asia/Shanghai +``` + +## 强制规则（必须遵守） +1. 飞书消息通知支持基于用户user_id发送，格式为`user:<用户user_id>`，用户user_id可从`/root/.openclaw/skills/lark-send-message-as-bot/vala_users_list.md`查询获取 +2. 时区强制指定为`Asia/Shanghai`，避免时间计算错误 +3. 一次性提醒必须加`--delete-after-run`参数，执行后自动清理过期任务 +4. 创建任务完成后必须按固定格式回复用户： +``` +✅ 定时任务已创建成功！ +- 任务ID：`{任务ID}` +- 触发时间：{本地时间}（{时间说明，如"10分钟后"、"每天8点"}） +- 通知对象：{用户姓名/标识} +- 通知内容：`{通知消息}` +- 执行后自动删除：{是/否} +``` +5. 不允许创建执行破坏性操作的定时任务 +6. 通知消息统一使用`⏰ `开头，保持格式一致 + +## 任务管理常用命令 +- 查看所有定时任务：`openclaw cron list` +- 删除指定任务：`openclaw cron rm <任务ID>` +- 手动执行验证任务：`openclaw cron run <任务ID>` +- 查看任务执行状态：`openclaw cron status <任务ID>`