Agent skill

QQ Bot Reminders

by tencent-connect in tencent-connect/openclaw-qqbot

Creates, lists and cancels one-time and recurring reminders for a QQ bot by calling its reminder and cron tools instead of promising in text.

MITAuto-check passedProductivity & Automation

SKILL.md written in Chinese; this summary is our English description.

Install QQ Bot Reminders

skills CLI
$ npx skills add tencent-connect/openclaw-qqbot --skill qqbot-remind -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tencent-connect/openclaw-qqbot qqbot-remind --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tencent-connect/openclaw-qqbot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/qqbot-remind .claude/skills/qqbot-remind && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
qqbot-remind
GitHub stars
1.6k
Token cost
~958 tokens
SKILL.md length
215 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Creates, lists and cancels one-time and recurring reminders for a QQ bot by calling its reminder and cron tools instead of promising in text.

  • Works in 3 steps: 调用 qqbot_remind:{ "action": "add",… → 收到返回的 cronParams → 立即调用 cron 工具,参数为该… → 回复用户:⏰ 好的,5分钟后提醒你喝水~
  • Setting a reminder that fires in a few minutes or hours
  • SKILL.md covers ⚠️ 强制规则, 推荐流程(优先使用 qqbot_remind 工具), 备用方案(直接使用 cron 工具) and cron 表达式速查, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill handles QQ bot reminders: creating one-time and recurring reminders, listing them and cancelling them. Its main rule is that any request involving a reminder, alarm or delay must trigger a tool call, because an agent that only replies that it will remind you has registered nothing. The skill file is in Chinese.

The preferred flow calls a qqbot_remind tool with an action, content and a time given as a relative value such as five minutes or as a cron expression. The tool returns parameters that must be passed unchanged to the cron tool, and the agent then confirms to the user. A fallback uses the cron tool directly with fixed fields that route the message through the QQ channel, absolute millisecond timestamps for one-time jobs and an Asia/Shanghai time zone for recurring ones. A cron cheat sheet and a decision table cover common phrasings, and the agent asks when the time is missing.

When your agent uses it

  • Setting a reminder that fires in a few minutes or hours
  • Creating a daily or weekday recurring reminder over QQ
  • Listing the reminders already scheduled
  • Cancelling or changing an existing reminder

Example prompts

  • “Remind me to drink water in five minutes.”
  • “Set a reminder every weekday at 9am to check my email.”
  • “What reminders do I have?”
  • “Cancel the drink-water reminder.”

Requirements

  • A QQ bot channel with the qqbot_remind and cron tools available

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 调用 qqbot_remind:{ "action": "add", "content": "喝水", "time": "5m" }
  2. 收到返回的 cronParams → 立即调用 cron 工具,参数为该 cronParams
  3. 回复用户:⏰ 好的,5分钟后提醒你喝水~

What it can do on your machine

Read from SKILL.md and the folder at commit b9ba494. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

QQ Bot Reminders loads about 958 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~958

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tencent-connect/openclaw-qqbot at commit b9ba494, republished under its MIT licence (© tencent-connect). 215 words, ~958 tokens.

Download SKILL.mdSave it as .claude/skills/qqbot-remind/SKILL.md (or your agent's skills folder).
name
qqbot-remind
description
QQBot 定时提醒。支持一次性和周期性提醒的创建、查询、取消。当通过 QQ 通道通信且涉及提醒/定时任务时使用。

QQ Bot 定时提醒

⚠️ 强制规则

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

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


推荐流程(优先使用 qqbot_remind 工具)

第一步:调用 qqbot_remind 工具,传入简单参数:

参数说明示例
action操作类型"add" / "list" / "remove"
content提醒内容"喝水"
to目标地址(可选,系统自动获取,通常无需填写)—
time时间(相对时间或 cron 表达式)"5m" / "1h30m" / "0 8 * * *"
jobId任务 ID(仅 remove)"xxx"

第二步:qqbot_remind 会返回 cronParams,你必须立即将 cronParams 的值原样作为参数调用 cron 工具。禁止修改、省略或重组 cronParams 中的任何字段(尤其是 delivery 对象中的 accountId)。

第三步:根据 cron 工具的返回结果,回复用户。

示例

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

  1. 调用 qqbot_remind:{ "action": "add", "content": "喝水", "time": "5m" }
  2. 收到返回的 cronParams → 立即调用 cron 工具,参数为该 cronParams
  3. 回复用户:⏰ 好的,5分钟后提醒你喝水~

备用方案(直接使用 cron 工具)

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

核心规则

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

5 个不可更改字段:

字段固定值原因
payload.kind"agentTurn"systemEvent 不会发 QQ 消息
delivery.mode"announce"投递模式
delivery.channel"qqbot"QQ 通道标识
delivery.to用户 openid从 To 字段获取
sessionTarget"isolated"隔离会话避免污染

delivery.accountId 必须填写当前会话的账户 ID(如果已知),以确保多账户场景下消息通过正确的机器人账户发送。

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

一次性提醒(schedule.kind = "at")
json
{
  "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": "{openid}",
      "accountId": "{accountId}"
    }
  }
}
周期提醒(schedule.kind = "cron")
json
{
  "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点缀"
    },
    "delivery": {
      "mode": "announce",
      "channel": "qqbot",
      "to": "{openid}",
      "accountId": "{accountId}"
    }
  }
}

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

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


AI 决策指南

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

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


回复模板

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

openclaw cron add \ --name "下班提醒" \ --at "2026-03-26T21:42:31+08:00" \ --message "test" \ --to …``

© tencent-connect, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/qqbot-remind of tencent-connect/openclaw-qqbot.

Open the folder on GitHubat commit b9ba494

Compare with similar skills

QQ Bot Reminders next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

QQ Bot Reminders compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
QQ Bot Reminders this skilltencent-connect/openclaw-qqbot1.6k—~958Automated safety check: PassMIT
Use Avibeavibe-bot/avibe622—~2.5kAutomated safety check: PassMIT
Twitter Monitorkangarooking/kangarooking-skills662—~798Automated safety check: PassNone
Task Manager0xranx/golembot322—~694Automated safety check: PassMIT
Slack Channel MonitorOpenHands/extensions163—~3.2kAutomated safety check: PassMIT
Feishu Cron Reminderzrt-ai-lab/opencode-skills287—~562Automated safety check: PassNone

Similar skills

  • Use Avibe

    avibe-bot/avibe

    Safely inspect and modify local Avibe configuration, routing, runtime settings, watches, scheduled tasks, Avibe Cloud remote access, and operational state.

    622 GitHub stars~2.5k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Twitter Monitor

    kangarooking/kangarooking-skills

    Fetch recent posts from one or more X/Twitter accounts through twitterapi.io, output structured JSON/CSV records, optionally sync records to Feishu/Lark Bitable through feishu-cli, and optionally…

    662 GitHub stars~798 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Task Manager

    0xranx/golembot

    Creates and manages scheduled tasks, cron jobs, recurring reminders, and timers via the Task HTTP API.

    322 GitHub stars~694 tokensUpdated 11 days ago
    Productivity & AutomationAuto-check passed
  • Slack Channel Monitor

    OpenHands/extensions

    This skill should be used when the user asks to "monitor a Slack channel", "watch Slack for messages", "create a Slack bot that responds to mentions", "set up an OpenHands Slack integration"…

    163 GitHub stars~3.2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Feishu Cron Reminder

    zrt-ai-lab/opencode-skills

    Create cron jobs that reliably deliver reminders to Feishu (飞书) chats.

    287 GitHub stars~562 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Minimal Web Baas Demo

    TencentCloudBase/CloudBase-AI-Toolkit

    Fast path for a minimal CloudBase Web + database demo (最小前后端 / 最小可用 fullstack / Lovable-like BaaS).

    1.1k GitHub starsUsed in 1 repo~2.3k tokens
    Productivity & AutomationAuto-check passed

More from tencent-connect/openclaw-qqbot

  • QQ Guild Channel Manager

    tencent-connect/openclaw-qqbot

    Manages QQ guilds and their sub-channels, members, posts, announcements and schedules through the qqbot_platform_api tool.

    1.6k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Questions about QQ Bot Reminders

What does QQ Bot Reminders do?

Creates, lists and cancels one-time and recurring reminders for a QQ bot by calling its reminder and cron tools instead of promising in text. This skill handles QQ bot reminders: creating one-time and recurring reminders, listing them and cancelling them. Its main rule is that any request involving a reminder, alarm or delay must trigger a tool call, because an agent that only replies that it will remind you has registered nothing.

When should I use QQ Bot Reminders?

QQ Bot Reminders fits situations like: setting a reminder that fires in a few minutes or hours; creating a daily or weekday recurring reminder over QQ; listing the reminders already scheduled; cancelling or changing an existing reminder.

How do I install QQ Bot Reminders in Claude Code?

Run `npx skills add tencent-connect/openclaw-qqbot --skill qqbot-remind -a claude-code`. Or copy the skill folder (skills/qqbot-remind in tencent-connect/openclaw-qqbot) into .claude/skills/qqbot-remind in your project. Claude Code loads it when a task matches its description.

How do I install QQ Bot Reminders in Codex?

Run `npx skills add tencent-connect/openclaw-qqbot --skill qqbot-remind -a codex`. Or copy the skill folder (skills/qqbot-remind in tencent-connect/openclaw-qqbot) into .agents/skills/qqbot-remind in your project. Codex loads it when a task matches its description.

Can I use QQ Bot Reminders in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tencent-connect/openclaw-qqbot --skill qqbot-remind -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qqbot-remind, .gemini/skills/qqbot-remind, .github/skills/qqbot-remind and .opencode/skills/qqbot-remind in your project.

What does QQ Bot Reminders need to run?

SKILL.md names no scripts, command-line tools or credentials: QQ Bot Reminders is instructions for the agent only. Our summary lists: A QQ bot channel with the qqbot_remind and cron tools available.

Does QQ Bot Reminders access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is QQ Bot Reminders safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does QQ Bot Reminders use?

QQ Bot Reminders is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does QQ Bot Reminders use?

About 958 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to QQ Bot Reminders?

Skills that share tags, products or a category with QQ Bot Reminders: Use Avibe (avibe-bot/avibe, 622 stars), Twitter Monitor (kangarooking/kangarooking-skills, 662 stars), Task Manager (0xranx/golembot, 322 stars) and Slack Channel Monitor (OpenHands/extensions, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains QQ Bot Reminders?

tencent-connect (a GitHub organization) maintains it in tencent-connect/openclaw-qqbot, which has 1,555 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 9, 2026.

Source: tencent-connect/openclaw-qqbot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.