schedule-manager
📅 管理工作区的定时任务和临时提醒
🚀 快速使用
bash
查看所有任务
python scripts/schedule.py list
添加定时任务
python scripts/schedule.py add --time 07:00 --name 起床提醒 --type tts --content 早上好 --weekday 1-5
添加临时任务（一次性）
python scripts/schedule.py temp --time 2026-03-02 10:00 --message 明天上午 10 点开会
修改任务
python scripts/schedule.py edit 起床提醒 --time 07:30
暂停任务
python scripts/schedule.py toggle 起床提醒
删除任务
python scripts/schedule.py delete 起床提醒
📋 命令说明
1. 查看任务
bash
查看所有定时任务
python scripts/schedule.py list
查看临时任务
python scripts/schedule.py list --temp
查看今日待执行临时任务
python scripts/schedule.py list --today
2. 添加定时任务
bash
python scripts/schedule.py add \
--time 07:00 \
--name 起床提醒 \
--type tts \
--content 早上好，该起床啦 \
--weekday 1-5 \
--notify 本地播放 + 飞书
参数说明：
| 参数 | 说明 | 必填 | 默认值 |
|---|
| --time | 执行时间 (HH:MM) | ✅ | - |
| --name |
任务名称 | ✅ | - |
| --type | 任务类型 (tts/news) | ✅ | - |
| --content | TTS 文本或新闻目录 | ✅ | - |
| --weekday | 星期规格 | ❌ | 1-7 |
| --notify | 通知方式 | ❌ | 本地播放 |
3. 添加临时任务
bash
指定日期时间
python scripts/schedule.py temp \
--time 2026-03-02 10:00 \
--message 明天上午 10 点开会
相对时间（1 小时后）
python scripts/schedule.py temp \
--in 1h \
--message 1 小时后提醒我
明天早上 8 点
python scripts/schedule.py temp \
--tomorrow 08:00 \
--message 明天早上 8 点提醒
临时任务参数：
| 参数 | 说明 | 示例 |
|---|
| --time | 绝对时间 | 2026-03-02 10:00 |
| --in |
相对时间 | 30m / 1h / 2d |
| --tomorrow | 明天指定时间 | 08:00 |
| --message | 提醒内容 | 开会 |
| --notify | 通知方式 | 本地播放 / 飞书 |
4. 修改任务
bash
修改时间
python scripts/schedule.py edit 起床提醒 --time 07:30
修改内容
python scripts/schedule.py edit 起床提醒 --content 早上好呀
修改星期
python scripts/schedule.py edit 起床提醒 --weekday 1-7
修改多个字段
python scripts/schedule.py edit 起床提醒 --time 07:30 --content 新内容
5. 启用/暂停任务
bash
切换状态（启用↔暂停）
python scripts/schedule.py toggle 起床提醒
直接启用
python scripts/schedule.py enable 起床提醒
直接暂停
python scripts/schedule.py disable 起床提醒
6. 删除任务
bash
删除定时任务
python scripts/schedule.py delete 起床提醒
删除临时任务
python scripts/schedule.py delete --temp 临时任务 ID
清理已过期的临时任务
python scripts/schedule.py cleanup
📁 文件结构
~/.openclaw/workspace/
├── daily-tasks.md # 定时任务配置
├── calendar/
│ ├── temp-tasks.md # 临时任务列表
│ └── daily-news/ # 新闻文件目录
├── task-logs/ # 执行日志
└── skills/schedule-manager/
├── SKILL.md # 本文件
└── scripts/
└── schedule.py # 主脚本
🔧 技术细节
定时任务存储
daily-tasks.md - Markdown 表格格式：
markdown
| 时间 | 任务名 | 类型 | 内容/参数 | 星期 | 通知方式 | 状态 |
|---|
| 07:00 | 起床提醒 | tts | 早上好 | 1-5 | 本地播放 + 飞书 | ✅ |
临时任务存储
calendar/temp-tasks.md - YAML 格式：
yaml
tasks:
- id: temp_001
time: 2026-03-02 10:00
message: 明天上午 10 点开会
notify: 本地播放 + 飞书
status: pending # pending / done / expired
created_at: 2026-03-01 18:00
crontab 集成
- - 定时任务：通过 crontab 精确执行
- 临时任务：心跳轮询检查（每 5 分钟）
💡 使用场景
每日固定任务
bash
工作日早上起床提醒
python scripts/schedule.py add \
--time 07:00 \
--name 起床提醒 \
--type tts \
--content 早上好，该起床啦 \
--weekday 1-5
每晚孩子睡觉提醒
python scripts/schedule.py add \
--time 21:30 \
--name 孩子洗漱 \
--type tts \
--content 宝贝，该洗漱准备睡觉啦 \
--weekday 1-7
临时提醒
bash
1 小时后提醒
python scripts/schedule.py temp --in 1h --message 该休息了
明天早上 9 点会议
python scripts/schedule.py temp --tomorrow 09:00 --message 周会
指定日期时间
python scripts/schedule.py temp --time 2026-03-05 14:00 --message 看牙医
任务管理
bash
查看所有任务
python scripts/schedule.py list
暂停周末任务
python scripts/schedule.py disable 周末跑步
修改任务时间
python scripts/schedule.py edit 起床提醒 --time 07:30
⚠️ 注意事项
- 1. 临时任务检查 - 需要心跳轮询（建议 5 分钟间隔）
- crontab 权限 - 确保用户有 crontab 权限
- 时间格式 - 使用 24 小时制 (HH:MM)
- 星期规格 - 1-5 (工作日), 1-7 (每天), 1,3,5 (隔天)
- 任务名称 - 必须唯一，不能重复
🛠️ 故障排查
任务不执行
bash
检查 crontab
crontab -l
检查任务状态
python scripts/schedule.py list
手动执行测试
~/.openclaw/workspace/scripts/run-task.sh 任务名 --force
临时任务不触发
bash
查看临时任务列表
python scripts/schedule.py list --temp
检查心跳配置
cat ~/.openclaw/workspace/HEARTBEAT.md
手动触发检查
python scripts/schedule.py check-temp
📞 相关文档
