---
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`
- 提醒内容：需要通知用户的具体消息，统一前缀为`⏰ `

**示例：**
用户需求："30分钟后提醒我开会"
执行命令：
```bash
openclaw cron add --at +30m --name "30分钟后开会提醒" --message "⏰ 提醒：时间到了，该去开会啦！" --announce --channel feishu --to user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87 --tz Asia/Shanghai --delete-after-run
```

### 2. 周期性定时任务（重复执行）
**参数规则：**
- cron表达式：标准cron格式 `分 时 日 月 周`，例如`0 8 * * *`表示每天8点
- 任务名称：便于识别的任务标识
- 执行内容/提醒消息：需要执行的操作或通知内容，统一前缀为`⏰ `

**示例：**
用户需求："每天早上8点提醒我备份数据"
执行命令：
```bash
openclaw cron add --cron "0 8 * * *" --name "每日8点数据备份提醒" --message "⏰ 每日提醒：请执行当日数据备份操作~" --announce --channel feishu --to user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87 --tz Asia/Shanghai
```

## 强制规则（必须遵守）
1. 所有定时任务默认投递到用户飞书账号 `user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87`，如果有其他用户需求，则对应投递到其飞书账号（格式：`user:<open_id>`）
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>`
