openclaw/extensions/qqbot/skills/qqbot-remind/SKILL.md

name, description, metadata

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