---
name: qqbot-remind
description: QQBot scheduled reminders. Use only for explicit user requests to create, list, or cancel one-time or recurring QQ reminders; ask for missing time, content, or timezone before scheduling.
metadata: { "openclaw": { "emoji": "⏰", "requires": { "config": ["channels.qqbot"] } } }
---

# QQ Bot 定时提醒

## ⚠️ 意图规则

只有当用户明确要求创建、查询或取消提醒/闹钟/定时任务时，才调用工具。闲聊、假设、解释提醒功能、讨论将来计划但未要求创建提醒时，不要调用工具。

如果用户确实要求提醒，你没有内存或后台线程，口头承诺"到时候提醒"是无效的——必须调用工具才能真正注册定时任务。时间、提醒内容、目标会话或时区不清楚时先追问；不要替用户猜测。

---

## 推荐流程（使用 `qqbot_remind` 工具）

**第一步**：调用 `qqbot_remind` 工具，传入简单参数：

| 参数       | 说明                                         | 示例                                        |
| ---------- | -------------------------------------------- | ------------------------------------------- |
| `action`   | 操作类型                                     | `"add"` / `"list"` / `"remove"`             |
| `content`  | 提醒内容                                     | `"喝水"`                                    |
| `to`       | 目标地址（可选，系统自动获取，通常无需填写） | —                                           |
| `time`     | 时间（相对时间或 cron 表达式）               | `"5m"` / `"1h30m"` / `"0 8 * * *"`          |
| `timezone` | IANA 时区（周期提醒建议明确传入）            | `"Asia/Shanghai"` / `"America/Los_Angeles"` |
| `jobId`    | 任务 ID（仅 remove）                         | `"xxx"`                                     |

**第二步**：根据 `qqbot_remind` 的返回结果，回复用户。`qqbot_remind` 会直接创建、查询或取消 Gateway cron 任务；成功后不要再调用 `cron` 工具。

### 示例

用户说："5分钟后提醒我喝水"

1. 调用 `qqbot_remind`：`{ "action": "add", "content": "喝水", "time": "5m" }`
2. 工具返回成功后，回复用户：`⏰ 好的，5分钟后提醒你喝水~`

`qqbot_remind` 不可用时，不要绕过它直接创建 Gateway 任务。说明当前无法安全注册 QQ 提醒，并建议用户检查 QQBot 工具配置。

---

## cron 表达式速查

| 场景           | expr             |
| -------------- | ---------------- |
| 每天早上8点    | `"0 8 * * *"`    |
| 每天晚上10点   | `"0 22 * * *"`   |
| 工作日早上9点  | `"0 9 * * 1-5"`  |
| 每周一早上9点  | `"0 9 * * 1"`    |
| 每周末上午10点 | `"0 10 * * 0,6"` |
| 每小时整点     | `"0 * * * *"`    |

> 周期提醒应使用用户明确提供、用户资料/会话中可信可得，或用户确认过的 IANA 时区。无法判断时先追问；不要把所有用户都假定在同一时区。

---

## AI 决策指南

| 用户说法            | action           | time 格式       |
| ------------------- | ---------------- | --------------- |
| "5分钟后提醒我喝水" | `add`            | `"5m"`          |
| "1小时后提醒开会"   | `add`            | `"1h"`          |
| "每天8点提醒我打卡" | `add`            | `"0 8 * * *"`   |
| "工作日早上9点提醒" | `add`            | `"0 9 * * 1-5"` |
| "我有哪些提醒"      | `list`           | —               |
| "取消喝水提醒"      | `remove`         | —               |
| "修改提醒时间"      | `remove` → `add` | —               |
| "提醒我"（无时间）  | **需追问**       | —               |

纯相对时间（"5分钟后"、"1小时后"）可直接计算，无需确认。时间、日期、周期、内容或时区模糊/缺失时需追问。周期提醒在回复中说明解释后的本地时间和时区。

---

## 回复模板

- 一次性：`⏰ 好的，{时间}后提醒你{内容}~`
- 周期：`⏰ 收到，{周期}提醒你{内容}~`
- 查询无结果：`📋 目前没有提醒哦~ 说"5分钟后提醒我xxx"试试？`
- 删除成功：`✅ 已取消"{名称}"`