QQ Bot 定时提醒使用指南

📝 简介

QQ Bot 支持强大的定时提醒功能，包括一次性提醒和周期性任务。

⏰ 一次性提醒

基本命令格式

openclaw cron add \
  --name "提醒名称" \
  --at "时间" \
  --session isolated \
  --message "提醒内容" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE" \
  --delete-after-run

时间格式

相对时间（常用）

5m - 5分钟后
30m - 30分钟后
1h - 1小时后
2h - 2小时后
1d - 1天后

⚠️ 重要：不要加 + 号，直接使用数字+单位

绝对时间

ISO 8601 格式：
- 2026-02-20T15:30:00+08:00（带时区）
- 2026-02-20T15:30:00（UTC时间）

实际示例

示例1：5分钟后提醒喝水

openclaw cron add \
  --name "提醒喝水" \
  --at "5m" \
  --session isolated \
  --message "💧 该喝水啦！保持水分充足~" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE" \
  --delete-after-run

示例2：明天早上8点提醒开会

openclaw cron add \
  --name "晨会提醒" \
  --at "1d" \
  --session isolated \
  --message "📅 早上好！记得9点有团队晨会" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE" \
  --delete-after-run

示例3：指定具体时间

openclaw cron add \
  --name "生日祝福" \
  --at "2026-03-15T12:00:00+08:00" \
  --session isolated \
  --message "🎂 生日快乐！" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE" \
  --delete-after-run

🔄 周期性任务（Cron）

基本格式

openclaw cron add \
  --name "任务名称" \
  --cron "cron表达式" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "任务内容" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE"

Cron 表达式速查

0 8 * * * - 每天上午8点
0 12 * * * - 每天中午12点
0 18 * * * - 每天晚上6点
0 9 * * 1 - 每周一上午9点
0 */6 * * * - 每6小时一次（0点、6点、12点、18点）

周期性任务示例

每天上午8点提醒打卡

openclaw cron add \
  --name "每日打卡提醒" \
  --cron "0 8 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "⏰ 早安！记得打卡上班~" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE"

每周五下午5点提醒周报

openclaw cron add \
  --name "周报提醒" \
  --cron "0 17 * * 5" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "📋 周五啦！别忘记提交本周工作总结" \
  --deliver \
  --channel qqbot \
  --to "33558EFB7CF362DA4A894FBE2E93DFDE"

📋 参数详解

参数	必须	说明
`--name`	是	任务名称，用于识别
`--at`	二选一	一次性任务的时间（相对或绝对）
`--cron`	二选一	周期性任务的cron表达式
`--tz`	周期性必选	时区（如 `Asia/Shanghai`）
`--message`	是	提醒内容，会原样发送给用户
`--session isolated`	是	使用独立会话
`--deliver`	是	启用消息投递
`--channel qqbot`	是	指定QQ Bot通道
`--to`	是	目标用户（您的OpenID）
`--delete-after-run`	一次性必选	运行后删除，避免残留

⚠️ 注意事项

所有提醒必须遵守：

一次性提醒必须包含 --delete-after-run 参数
周期性任务必须包含 --tz 时区参数
--message 不能为空，必须有实际内容
相对时间格式（如 5m）不要加 + 号
cron add 命令不支持 --reply-to 参数
定时提醒只能作为主动消息发送，不能作为回复

🔍 管理定时任务

查看所有任务

openclaw cron list

查看已禁用任务（包含历史已完成任务）

openclaw cron list --include-disabled

删除指定任务

openclaw cron remove --id <jobId>

立即运行某个任务

openclaw cron run --id <jobId>

查询任务执行历史

openclaw cron runs --id <jobId>

💡 实用技巧

先测试：设置一个5分钟后的测试提醒，确认功能正常
内容要有温度：提醒消息可以加入表情符号，更友好
命名要清晰：以便于后续识别和管理
周期性任务：确保时区设置正确（中国使用 Asia/Shanghai）
及时清理：定期用 openclaw cron list 查看并清理不再需要的任务

🆘 常见问题

Q: 为什么我设置的提醒没有触发？
A: 检查：1) 时间格式是否正确 2) 参数是否完整 3) 网络连接是否正常

Q: 如何修改已创建的提醒？
A: 目前不支持直接修改，建议删除后重新创建

Q: 可以设置提前几天的提醒吗？
A: 可以，使用绝对时间格式，如 2026-03-01T09:00:00+08:00

Last Updated: 2026-02-20
适用于 OpenClaw QQ Bot 版本

📄 qqbot-cron-guide.md