mcpField
Q
qqbot-cron

qqbot-cron

github.com/tencent-connectProductivity1.6k321 installsUpdated 2w ago
Repository

About qqbot-cron

qqbot-cron is a scheduling skill for QQ Bot assistants, defining how to register and manage reminders with cron. It specifies QQ delivery fields, timestamp formatting, and timezone requirements for recurring jobs.

Key features

  1. 01Schedule one-time and recurring reminders
  2. 02List, remove, and modify reminders
  3. 03Set jobs with absolute millisecond timestamps
  4. 04Use Asia/Shanghai for recurring schedules

Use cases

  1. 01Schedule a reminder minutes or hours later
  2. 02Set daily or weekday reminders
  3. 03Review existing reminders and cancel jobs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tencent-connect/openclaw-qqbot --skill qqbot-cron

After installing, type/qqbot-cronin Claude Code to confirm it loaded.

Details

From the project README

QQ Bot 定时提醒

⚠️ 强制规则

当用户提到「提醒」「闹钟」「定时」「X分钟/小时后」「每天X点」「叫我」等任何涉及延时或定时的请求时，你必须调用 cron 工具，绝对不能只用自然语言回复说"好的，我会提醒你"！

你没有内存或后台线程，口头承诺"到时候提醒"是无效的——只有调用 cron 工具才能真正注册定时任务。

核心规则

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

5 个不可更改字段：

字段固定值原因
payload.kind"agentTurn"systemEvent 不会发 QQ 消息
payload.delivertrue否则不投递
payload.channel"qqbot"QQ 通道标识
payload.to用户 openid从上下文获取
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点缀",
      "deliver": true,
      "channel": "qqbot",
      "to": "{openid}"
    }
  }
}
周期提醒（schedule.kind = "cron"）
{
  "action": "add",
  "job": {
    "name": "{任务名}",
    "schedule": { "kind": "cron", "expr": "0 8 * * *", "tz": "Asia/Shanghai" },
    "sessionTarget": "isolated",
    "wakeMode": "now",
    "payload": {
      "kind": "agentTurn",
      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀",
      "deliver": true,
      "channel": "qqbot",
      "to": "{openid}"
    }
  }
}

周期任务不加 deleteAfterRun。群聊 to 格式为 "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 * * * *"

周期提醒必须加 "tz": "Asia/Shanghai"。

查询与删除

  • 查询：{ "action": "list" }
  • 删除：先 list 找到 jobId，再 { "action": "remove", "jobId": "{id}" }
  • 修改：删除后重建

AI 决策指南

用户说法actionschedule.kind
"5分钟后提醒我喝水"addat
"每天8点提醒我打卡"addcron
"我有哪些提醒"list—
"取消喝水提醒"remove—
"修改提醒时间"remove → add—
"提醒我"（无时间）需追问—

纯相对时间（"5分钟后"、"1小时后"）可直接计算，无需确认。时间模糊或缺失时需追问。

回复模板

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

Comments

Markdown supported