---

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分钟后提醒你喝水~

---

备用方案（直接使用 cron 工具）

仅当 qqbot_remind 工具不可用但 cron 工具可用时使用以下方式。

核心规则

payload.kind 必须是 "agentTurn"，绝对不能用 "systemEvent"！ systemEvent 只在 AI 会话内部注入文本，用户收不到 QQ 消息。

不可更改字段：

| 字段 | 固定值 | 原因 | | -------------------- | ------------- | ---------------------------- | | payload.kind | "agentTurn" | systemEvent 不会发 QQ 消息 | | delivery.mode | "announce" | 主动投递模式 | | delivery.channel | "qqbot" | QQ 通道标识 | | delivery.to | 目标地址 | 从当前会话上下文获取 | | delivery.accountId | 当前账户 ID | 多账号场景下不可省略 | | sessionTarget | "isolated" | 隔离会话避免污染 |

schedule.atMs 必须是绝对毫秒时间戳（如 1770733800000），不支持 "5m" 等相对字符串。 计算方式：当前时间戳ms + 延迟毫秒。

一次性提醒（schedule.kind = "at"）

{
  "action": "add",
  "job": {
    "name": "{任务名}",
    "schedule": { "kind": "at", "atMs": "{当前时间戳ms + N*60000}" },
    "sessionTarget": "isolated",
    "wakeMode": "now",
    "deleteAfterRun": true,
    "payload": {
      "kind": "agentTurn",
      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀"
    },
    "delivery": {
      "mode": "announce",
      "channel": "qqbot",
      "to": "qqbot:c2c:{openid}",
      "accountId": "{accountId}"
    }
  }
}

周期提醒（schedule.kind = "cron"）

{
  "action": "add",
  "job": {
    "name": "{任务名}",
    "schedule": { "kind": "cron", "expr": "0 8 * * *", "tz": "{用户确认的 IANA 时区}" },
    "sessionTarget": "isolated",
    "wakeMode": "now",
    "payload": {
      "kind": "agentTurn",
      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀"
    },
    "delivery": {
      "mode": "announce",
      "channel": "qqbot",
      "to": "qqbot:c2c:{openid}",
      "accountId": "{accountId}"
    }
  }
}

周期任务不加 deleteAfterRun。群聊 delivery.to 格式为 "qqbot:group:{group_openid}"。

---

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"试试？
• 删除成功：✅ 已取消"{名称}"