mirror of https://github.com/hansjone/oclaw.git synced 2026-10-18 22:00:46 +08:00

oliver dbbe3add6a 重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。

同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。

Made-with: Cursor

2026-04-26 08:34:33 +08:00

6 KiB

Raw Blame History

name

description

metadata

qqbot-remind

QQBot 定时提醒。支持一次性和周期性提醒的创建、查询、取消。当通过 QQ 通道通信且涉及提醒/定时任务时使用。

openclaw

emoji

requires

⏰

config

channels.qqbot

QQ Bot 定时提醒

⚠️ 强制规则

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

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

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

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

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

核心规则

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

5 个不可更改字段：

字段	固定值	原因
`payload.kind`	`"agentTurn"`	`systemEvent` 不会发 QQ 消息
`payload.deliver`	`true`	否则不投递
`payload.channel`	`"qqbot"`	QQ 通道标识
`payload.to`	用户 openid	从 `To` 字段获取
`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"。

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

6 KiB Raw Blame History Unescape Escape