npm - @sliverp/qqbot - Versions diffs - 1.4.1 → 1.4.2 - Mend

@sliverp/qqbot 1.4.1 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.bak.md +261 -0
package/README.md +72 -214
package/README.zh.md +115 -0
package/package.json +2 -1
package/skills/qqbot-cron/SKILL.md +490 -0
package/skills/qqbot-media/SKILL.md +138 -0

package/README.bak.md ADDED Viewed

@@ -0,0 +1,261 @@
+<div align="center">
+# QQ Bot Channel Plugin for Openclaw(Clawdbot/Moltbot)
+QQ 开放平台 Bot API 的 Openclaw 渠道插件，支持 C2C 私聊、群聊 @消息、频道消息。
+[![npm version](https://img.shields.io/badge/npm-v1.4.1-blue)](https://www.npmjs.com/package/@sliverp/qqbot)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
+[![Platform](https://img.shields.io/badge/platform-Openclaw-orange)](https://github.com/sliverp/openclaw)
+[![Node.js](https://img.shields.io/badge/Node.js->=18-339933)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6)](https://www.typescriptlang.org/)
+</div>
+---
+## 📸 使用示例
+<div align="center">
+<img width="400" alt="使用示例" src="https://github.com/user-attachments/assets/6f1704ab-584b-497e-8937-96f84ce2958f" />
+<img width="670" height="396" alt="Clipboard_Screenshot_1770366319" src="https://github.com/user-attachments/assets/e21e9292-fb93-41a7-81fe-39eeefe3b01d" />
+</div>
+---
+## ✨ 功能特性
+- 🔒 **多场景支持** - C2C 私聊、群聊 @消息、频道消息、频道私信
+- 🖼️ **富媒体消息** - 支持图片收发、文件发送
+- ⏰ **定时推送** - 支持定时任务到时后主动推送
+- 🔗 **URL 无限制** - 私聊可直接发送 URL
+- ⌨️ **输入状态** - Bot 正在输入中状态提示
+- 🔄 **热更新** - 支持 npm 方式安装和热更新
+- 📝 **Markdown** - 支持 Markdown 格式
+- 📝 **Command** - 支持Openclaw原生命令
+---
+## ⭐ Star 趋势
+<div align="center">
+<img width="666" height="464" alt="star-history-202626 (1)" src="https://github.com/user-attachments/assets/01d123b4-f2a7-45b9-b2ed-b7a344497b4a" />
+</div>
+---
+## 📦 安装
+### 方式一：腾讯云 Lighthouse 镜像（最简单）
+[![Lighthouse](https://img.shields.io/badge/腾讯云-Lighthouse_镜像-00A4FF)](https://cloud.tencent.com/product/lighthouse)
+直接使用预装好的腾讯云 Lighthouse 镜像，开箱即用，无需手动安装配置。
+### 方式二：npm 安装（推荐）
+```bash
+openclaw plugins install @sliverp/qqbot@1.3.7
+```
+### 方式三：源码安装
+```bash
+git clone https://github.com/sliverp/qqbot.git && cd qqbot
+clawdbot plugins install .
+```
+> 💡 安装过程需要一些时间，尤其是小内存机器，请耐心等待
+---
+## ⚙️ 配置
+### 1. 获取 QQ 机器人凭证
+1. 访问 [QQ 开放平台](https://q.qq.com/)
+2. 创建机器人应用
+3. 获取 `AppID` 和 `AppSecret`（ClientSecret）
+4. Token 格式：`AppID:AppSecret`
+### 2. 添加配置
+**交互式配置：**
+```bash
+clawdbot channels add
+# 选择 qqbot，按提示输入 Token
+```
+**命令行配置：**
+```bash
+clawdbot channels add --channel qqbot --token "AppID:AppSecret"
+```
+### 3. 手动编辑配置（可选）
+编辑 `~/.clawdbot/clawdbot.json`：
+```json
+{
+  "channels": {
+    "qqbot": {
+      "enabled": true,
+      "appId": "你的AppID",
+      "clientSecret": "你的AppSecret"
+    }
+  }
+}
+```
+---
+## 🚀 使用
+### 启动服务
+```bash
+# 后台启动
+clawdbot gateway restart
+# 前台启动（查看日志）
+clawdbot gateway --port 18789 --verbose
+```
+### CLI 配置向导
+```bash
+clawdbot onboard
+# 选择 QQ Bot 进行交互式配置
+```
+---
+## ⚠️ 注意事项
+- **群消息**：需要在群内 @机器人 才能触发回复
+- **沙箱模式**：新创建的机器人默认在沙箱模式，需要添加测试用户
+---
+## 🔄 升级
+### npm 热更新
+```bash
+npx -y @sliverp/qqbot@1.3.7 upgrade
+```
+> 热更新后无需重新配置 AppId 和 AppSecret。该方式Openclaw和Node.js会占用大量内存，小内存机器优先建议使用源码方式热更新
+### 源码热更新
+```bash
+git clone https://github.com/sliverp/qqbot.git && cd qqbot
+# 运行升级脚本
+bash ./scripts/upgrade.sh
+# 重新安装
+clawdbot plugins install .
+# 重新配置
+clawdbot channels add --channel qqbot --token "AppID:AppSecret"
+# 重启网关
+clawdbot gateway restart
+```
+升级脚本会自动清理旧版本和配置。
+---
+## 📚 版本历史
+<details>
+<summary><b>v1.4.0</b></summary>
+- 支持 Markdown 格式
+</details>
+<details>
+<summary><b>v1.3.13 - 2026.02.06</b></summary>
+- ✨ 支持Openclawd内置指令“/compact" , "/new"等（注意，/reset等命令有危险性，非常不建议把Bot拉入群聊）
+- 🐛 修复在一些情况下”正在输入“不生效的问题
+</details>
+<details>
+<summary><b>v1.3.0 - 2026.02.03</b></summary>
+- ✨ 支持图片收发等功能
+- ✨ 支持定时任务到时后主动推送
+- ✨ 支持使用 npm 等方式安装和升级
+- 🐛 优化一些已知问题
+</details>
+<details>
+<summary><b>v1.2.5 - 2026.02.02</b></summary>
+- ✨ 解除 URL 发送限制
+- ✨ 更新 Bot 正在输入中状态
+- ✨ 提供主动推送能力
+- 🐛 优化一些已知问题
+</details>
+<details>
+<summary><b>v1.2.2 - 2026.01.31</b></summary>
+- ✨ 支持发送文件
+- ✨ 支持 openclaw、moltbot 命令行
+- 🐛 修复 health 检查提示问题
+- 🐛 修复文件发送后 clawdbot 无法读取的问题
+</details>
+<details>
+<summary><b>v1.2.1</b></summary>
+- 🐛 解决长时间使用会断联的问题
+- 🐛 解决频繁重连的问题
+- ✨ 增加大模型调用失败后的提示消息
+</details>
+<details>
+<summary><b>v1.1.0</b></summary>
+- 🐛 解决 URL 被拦截的问题
+- 🐛 解决多轮消息发送失败的问题
+- 🐛 修复部分图片无法接收的问题
+- ✨ 增加支持 onboard 配置方式
+</details>
+---
+## 🔗 相关链接
+- [QQ 机器人官方文档](https://bot.q.qq.com/wiki/)
+- [QQ 开放平台](https://q.qq.com/)
+- [API v2 文档](https://bot.q.qq.com/wiki/develop/api-v2/)
+---
+## 📄 License
+MIT

package/README.md CHANGED Viewed

@@ -1,267 +1,125 @@
-<div align="center">
+# QQ
-# QQ Bot Channel Plugin for Moltbot
+QQ is a widely-used instant messaging platform that provides various communication capabilities such as text, voice, images, and files. It supports collaborative scenarios like group chats and channels, making it suitable for both personal communication and team collaboration.
-QQ 开放平台 Bot API 的 Moltbot 渠道插件，支持 C2C 私聊、群聊 @消息、频道消息。
+This integration method connects OpenClaw with a QQ Bot. It utilizes the platform's long-connection event subscription mechanism to receive message and event callbacks, enabling stable and secure message exchange and automation capability integration without exposing a public webhook address.
-[![npm version](https://img.shields.io/badge/npm-v1.3.7-blue)](https://www.npmjs.com/package/@sliverp/qqbot)
-[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
-[![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
-[![Platform](https://img.shields.io/badge/platform-Moltbot-orange)](https://github.com/sliverp/moltbot)
-[![Node.js](https://img.shields.io/badge/Node.js->=18-339933)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6)](https://www.typescriptlang.org/)
+# Step 1: Install the QQ Bot Plugin
-</div>
+Install via the OpenClaw plugins command.
----
+```
+openclaw plugins install @sliverp/qqbot@latest
+```
-## ⭐ Star 趋势
+Install from source code:
-<!-- 在这里放置 Star 数量变化图 -->
+```
+git clone https://github.com/sliverp/qqbot.git && cd qqbot
+openclaw plugins install .
+```
----
+# Step 2: Create a QQ Bot
-## 📸 使用示例
+## 1. Register on the QQ Open Platform
-<img width="600" alt="使用示例" src="https://github.com/user-attachments/assets/6f1704ab-584b-497e-8937-96f84ce2958f" />
+Go to the official website of the Tencent QQ Open Platform. You cannot log in directly with your personal QQ account by default; you need to register a new QQ Open Platform account.
+<img width="2140" height="1004" alt="1" src="https://github.com/user-attachments/assets/d76a780c-5040-43fb-ac41-5808f975ae4b" />
----
+After the initial registration, follow the platform's instructions to set up a super administrator.
-## ✨ 功能特性
+<img width="2556" height="1744" alt="2" src="https://github.com/user-attachments/assets/ad0a54d5-6997-4f52-ae8f-bea71aa11c30" />
+After successfully scanning the QR code with your mobile QQ, proceed to the next step to fill in the relevant entity information.
-- 🔒 **多场景支持** - C2C 私聊、群聊 @消息、频道消息、频道私信
-- 🖼️ **富媒体消息** - 支持图片收发、文件发送
-- ⏰ **定时推送** - 支持定时任务到时后主动推送
-- 🔗 **URL 无限制** - 私聊可直接发送 URL
-- ⌨️ **输入状态** - Bot 正在输入中状态提示
-- 🔄 **热更新** - 支持 npm 方式安装和热更新
-- 📝 **Markdown** - 支持 Markdown 格式（即将更新）
+Using "Individual" as an example here, follow the prompts to enter your name, ID number, phone number, and verification code, then click continue to proceed to the facial recognition step.
+<img width="2544" height="1744" alt="3" src="https://github.com/user-attachments/assets/b85c11f8-5627-4e08-b522-b38c4929bcb6" />
----
+Use your mobile QQ to scan the QR code for facial recognition.
+<img width="2542" height="1272" alt="4" src="https://github.com/user-attachments/assets/d0db5539-56ef-4189-930f-595348892bef" />
-## 📦 安装
+Once the facial recognition review is approved, you can log in to the QQ Open Platform.
+<img width="2356" height="1308" alt="5" src="https://github.com/user-attachments/assets/c1875b27-fefc-4a1c-81ef-863da8b15ec6" />
-### 方式一：腾讯云 Lighthouse 镜像（最简单）
+## 2. Create a QQ Bot
-[![Lighthouse](https://img.shields.io/badge/腾讯云-Lighthouse_镜像-00A4FF)](https://cloud.tencent.com/product/lighthouse)
+On the QQ Open Platform's QQ Bot page, you can create a bot.
+<img width="2334" height="1274" alt="6" src="https://github.com/user-attachments/assets/8389c38d-6662-46d0-ae04-92af374b61ef" />
+<img width="2316" height="1258" alt="7" src="https://github.com/user-attachments/assets/15cfe57a-0404-4b02-85fe-42a22cf96d01" />
-直接使用预装好的腾讯云 Lighthouse 镜像，开箱即用，无需手动安装配置。
+After the QQ Bot is created, you can select it and click to enter the management page.
+<img width="3002" height="1536" alt="8" src="https://github.com/user-attachments/assets/7c0c7c69-29db-457f-974a-4aa52ebd7973" />
-### 方式二：npm 安装（推荐）
+On the QQ Bot management page, obtain the current bot's AppID and AppSecret, copy them, and save them to your personal notepad or memo (please ensure data security and do not leak them). They will be needed later in "Step 3: Configuring OpenClaw".
-```bash
-openclaw plugins install @sliverp/qqbot@1.3.7
-```
+Note: For security reasons, the QQ Bot's AppSecret is not stored in plain text. If you view it for the first time or forget it, you need to regenerate it.
+<img width="2970" height="1562" alt="9" src="https://github.com/user-attachments/assets/c7fc3094-2840-4780-a202-47b2c2b74e50" />
+<img width="1258" height="594" alt="10" src="https://github.com/user-attachments/assets/4445bede-e7d5-4927-9821-039e7ad8f1f5" />
-### 方式三：源码安装
+## 3. Sandbox Configuration
-```bash
-git clone https://github.com/sliverp/qqbot.git && cd qqbot
-clawdbot plugins install .
-```
+On the QQ Bot's "Development Management" page, in the "Sandbox Configuration" section, set up private chat (select "Configure in Message List").
-> 💡 安装过程需要一些时间，尤其是小内存机器，请耐心等待
+You can configure this according to your own usage scenario, or you can complete the subsequent steps and then return to this step to operate.
----
+⚠️ Note:
+The QQ Bot created here does not need to be published and made available to all QQ users. It can be used for personal (sandbox) debugging and experience.
+The QQ Open Platform does not support "Configuration in QQ Groups" for bots; it only supports private chat with the QQ Bot.
+<img width="1904" height="801" alt="11" src="https://github.com/user-attachments/assets/f3940a87-aae7-4c89-8f9a-c94fb52cd3ea" />
-## ⚙️ 配置
+Note: When selecting "Configure in Message List", you need to first add members, and then use the QQ scan code of that member to add the bot.
+<img width="2582" height="484" alt="12" src="https://github.com/user-attachments/assets/5631fe76-2205-4b1e-b463-75fa3a397464" />
+Note here that after successfully adding a member, you still need to use QQ scan code to add the bot.
-### 1. 获取 QQ 机器人凭证
+<img width="2286" height="1324" alt="13" src="https://github.com/user-attachments/assets/cbf379be-ef6e-4391-8cb1-67c08aad2d43" />
+At this point, after adding the bot to your QQ account, you still cannot have a normal conversation with it. You will receive a prompt saying "The bot has gone to Mars, please try again later." This is because the QQ bot has not yet been connected to the OpenClaw application.
-1. 访问 [QQ 开放平台](https://q.qq.com/)
-2. 创建机器人应用
-3. 获取 `AppID` 和 `AppSecret`（ClientSecret）
-4. Token 格式：`AppID:AppSecret`
+You need to proceed with the following steps to configure the QQ bot's AppID and AppSecret for the OpenClaw application.
-### 2. 添加配置
+<img width="872" height="1052" alt="14" src="https://github.com/user-attachments/assets/0c02aaf6-6cf9-419c-a6ab-36398d73c5ba" />
-**交互式配置：**
+(Optional) You can also add more members by referring to the previous steps: First, add a new member in the member management page, then add the member in the sandbox configuration page. After that, the new member can add this QQ bot by scanning the QR code with QQ.
+<img width="3006" height="1504" alt="15" src="https://github.com/user-attachments/assets/cecef3a6-0596-4da0-8b92-8d67b8f3cdca" />
+<img width="2902" height="1394" alt="16" src="https://github.com/user-attachments/assets/eb98ffce-490f-402c-8b0c-af7ede1b1303" />
+<img width="1306" height="672" alt="17" src="https://github.com/user-attachments/assets/799056e3-82a6-44bc-9e3d-9c840faafa41" />
-```bash
-clawdbot channels add
-# 选择 qqbot，按提示输入 Token
-```
+# Step 3: Configure OpenClaw
+## Method 1: Configure via Wizard (Recommended)
-**命令行配置：**
+Add the qqbot channel and input the AppID and AppSecret obtained in Step 2.
-```bash
-clawdbot channels add --channel qqbot --token "AppID:AppSecret"
+```
+openclaw channels add --channel qqbot --token "AppID:AppSecret"
 ```
-### 3. 手动编辑配置（可选）
+## Method 2: Configure via Configuration File
-编辑 `~/.clawdbot/clawdbot.json`：
+Edit ~/.openclaw/openclaw.json:
-```json
+``` json
 {
   "channels": {
     "qqbot": {
       "enabled": true,
-      "appId": "你的AppID",
-      "clientSecret": "你的AppSecret"
+      "appId": "Your AppID",
+      "clientSecret": "Your AppSecret"
     }
   }
 }
 ```
----
-## 📋 配置项说明
-| 配置项 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| `appId` | string | ✅ | QQ 机器人 AppID |
-| `clientSecret` | string | ✅* | AppSecret，与 `clientSecretFile` 二选一 |
-| `clientSecretFile` | string | ✅* | AppSecret 文件路径 |
-| `enabled` | boolean | ❌ | 是否启用，默认 `true` |
-| `name` | string | ❌ | 账户显示名称 |
-| `systemPrompt` | string | ❌ | 自定义系统提示词 |
----
-## 📨 支持的消息类型
-| 事件类型 | 说明 | Intent |
-|----------|------|--------|
-| `C2C_MESSAGE_CREATE` | C2C 单聊消息 | `1 << 25` |
-| `GROUP_AT_MESSAGE_CREATE` | 群聊 @机器人消息 | `1 << 25` |
-| `AT_MESSAGE_CREATE` | 频道 @机器人消息 | `1 << 30` |
-| `DIRECT_MESSAGE_CREATE` | 频道私信 | `1 << 12` |
+# Step 4: Start and Test
----
+## 1. Start the gateway
-## 🚀 使用
-### 启动服务
-```bash
-# 后台启动
-clawdbot gateway restart
-# 前台启动（查看日志）
-clawdbot gateway --port 18789 --verbose
-```
-### CLI 配置向导
-```bash
-clawdbot onboard
-# 选择 QQ Bot 进行交互式配置
 ```
----
-## ⚠️ 注意事项
-- **群消息**：需要在群内 @机器人 才能触发回复
-- **沙箱模式**：新创建的机器人默认在沙箱模式，需要添加测试用户
----
-## 🔄 升级
-### npm 热更新
-```bash
-npx -y @sliverp/qqbot@1.3.7 upgrade
+openclaw gateway
 ```
-> 热更新后无需重新配置 AppId 和 AppSecret
-### 源码热更新
-```bash
-git clone https://github.com/sliverp/qqbot.git && cd qqbot
-# 运行升级脚本
-bash ./scripts/upgrade.sh
-# 重新安装
-clawdbot plugins install .
-# 重新配置
-clawdbot channels add --channel qqbot --token "AppID:AppSecret"
-# 重启网关
-clawdbot gateway restart
-```
-升级脚本会自动清理旧版本和配置。
----
----
-## 📚 版本历史
-<details>
-<summary><b>v1.4.0（即将更新）</b></summary>
-- 支持 Markdown 格式
-</details>
-<details>
-<summary><b>v1.3.0 - 2026.02.03</b></summary>
-- ✨ 支持图片收发等功能
-- ✨ 支持定时任务到时后主动推送
-- ✨ 支持使用 npm 等方式安装和升级
-- 🐛 优化一些已知问题
-</details>
-<details>
-<summary><b>v1.2.5 - 2026.02.02</b></summary>
-- ✨ 解除 URL 发送限制
-- ✨ 更新 Bot 正在输入中状态
-- ✨ 提供主动推送能力
-- 🐛 优化一些已知问题
-</details>
-<details>
-<summary><b>v1.2.2 - 2026.01.31</b></summary>
-- ✨ 支持发送文件
-- ✨ 支持 openclaw、moltbot 命令行
-- 🐛 修复 health 检查提示问题
-- 🐛 修复文件发送后 clawdbot 无法读取的问题
-</details>
-<details>
-<summary><b>v1.2.1</b></summary>
-- 🐛 解决长时间使用会断联的问题
-- 🐛 解决频繁重连的问题
-- ✨ 增加大模型调用失败后的提示消息
-</details>
-<details>
-<summary><b>v1.1.0</b></summary>
-- 🐛 解决 URL 被拦截的问题
-- 🐛 解决多轮消息发送失败的问题
-- 🐛 修复部分图片无法接收的问题
-- ✨ 增加支持 onboard 配置方式
-</details>
----
-## 🔗 相关链接
-- [QQ 机器人官方文档](https://bot.q.qq.com/wiki/)
-- [QQ 开放平台](https://q.qq.com/)
-- [API v2 文档](https://bot.q.qq.com/wiki/develop/api-v2/)
+## 2. Chat with the QQbot in QQ
----
+<img width="990" height="984" alt="18" src="https://github.com/user-attachments/assets/b2776c8b-de72-4e37-b34d-e8287ce45de1" />
-## 📄 License
-MIT
+# Other Language README
+[简体中文](README.zh.md)

package/README.zh.md ADDED Viewed

@@ -0,0 +1,115 @@
+# QQ
+QQ 是一款覆盖广泛用户群体的即时通讯平台，提供文字、语音、图片、文件等多种沟通能力，并支持群聊、频道等协作场景，适用于个人交流与团队协同。
+该接入方式可将 OpenClaw 与 QQ Bot 进行连接，通过平台的长连接事件订阅机制接收消息与事件回调，从而在不对外暴露公网 Webhook 地址的情况下实现稳定、安全的消息收发与自动化能力集成。
+# 步骤1:安装QQ Bot插件
+OpenClaw plugins命令安装
+```
+openclaw plugins install @sliverp/qqbot@latest
+```
+使用源码安装：
+```
+git clone https://github.com/sliverp/qqbot.git && cd qqbot
+openclaw plugins install .
+```
+# 步骤2:创建QQ Bot
+## 1.注册QQ开放平台
+前往腾讯QQ开放平台官网，默认无法使用您的QQ账号直接登录，需要新注册QQ开放平台账号。
+<img width="2140" height="1004" alt="1" src="https://github.com/user-attachments/assets/d76a780c-5040-43fb-ac41-5808f975ae4b" />
+首次注册之后，可以按照QQ开放平台的指引设置超级管理员。
+<img width="2556" height="1744" alt="2" src="https://github.com/user-attachments/assets/ad0a54d5-6997-4f52-ae8f-bea71aa11c30" />
+手机QQ扫码成功后，继续下一步填写主体相关信息。
+此处以“个人”为例，按照指引依次输入姓名、身份证号、手机号、验证码，点击继续进入下一步人脸认证。
+<img width="2544" height="1744" alt="3" src="https://github.com/user-attachments/assets/b85c11f8-5627-4e08-b522-b38c4929bcb6" />
+使用手机QQ扫码进行人脸认证。
+<img width="2542" height="1272" alt="4" src="https://github.com/user-attachments/assets/d0db5539-56ef-4189-930f-595348892bef" />
+人脸识别审核通过后，即可登录进入QQ开放平台。
+<img width="2356" height="1308" alt="5" src="https://github.com/user-attachments/assets/c1875b27-fefc-4a1c-81ef-863da8b15ec6" />
+## 2.创建一个QQBot机器人
+在QQ开放平台的QQ机器人页面，可以创建机器人。
+<img width="2334" height="1274" alt="6" src="https://github.com/user-attachments/assets/8389c38d-6662-46d0-ae04-92af374b61ef" />
+<img width="2316" height="1258" alt="7" src="https://github.com/user-attachments/assets/15cfe57a-0404-4b02-85fe-42a22cf96d01" />
+QQ机器人创建完成之后，可选择机器人点击进入管理页面。
+<img width="3002" height="1536" alt="8" src="https://github.com/user-attachments/assets/7c0c7c69-29db-457f-974a-4aa52ebd7973" />
+在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“步骤3中配置OpenClaw“中需要使用。
+注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。
+<img width="2970" height="1562" alt="9" src="https://github.com/user-attachments/assets/c7fc3094-2840-4780-a202-47b2c2b74e50" />
+<img width="1258" height="594" alt="10" src="https://github.com/user-attachments/assets/4445bede-e7d5-4927-9821-039e7ad8f1f5" />
+## 3.沙箱配置
+在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。
+您可以按照自己的使用场景进行配置，也可以完成后续步骤之后再回到本步骤进行操作。
+⚠️ 注意：
+此处已创建的QQ机器人无需进行发布上架对所有QQ用户公开使用，在开发者私人的（沙箱）调试下使用体验即可。
+QQ开放平台不支持机器人的“在QQ群配置”操作，只支持单独和QQ机器人聊天。
+<img width="1904" height="801" alt="11" src="https://github.com/user-attachments/assets/f3940a87-aae7-4c89-8f9a-c94fb52cd3ea" />
+注意：选择“在消息列表配置”时，需要先添加成员，再通过该成员的QQ扫码来添加机器人。
+<img width="2582" height="484" alt="12" src="https://github.com/user-attachments/assets/5631fe76-2205-4f1e-b463-75fa3a397464" />
+此处注意添加成员成功之后，还需要使用QQ扫码添加
+<img width="2286" height="1324" alt="13" src="https://github.com/user-attachments/assets/cbf379be-ef6e-4391-8cb1-67c08aad2d43" />
+此时您的QQ账号添加机器人之后，还不能与该机器人正常进行对话，会提示“该机器人去火星了，稍后再试吧”，因为QQ机器人此时尚未与OpenClaw应用打通。
+您需要继续后面的步骤，为OpenClaw应用配置QQ机器人的AppID和AppSecret。
+<img width="872" height="1052" alt="14" src="https://github.com/user-attachments/assets/0c02aaf6-6cf9-419c-a6ab-36398d73c5ba" />
+（可选）您也可以参考前述步骤添加更多成员：首先在成员管理页面中添加新成员，然后在沙箱配置页面中添加成员，之后新成员即可通过QQ扫码添加该QQ机器人。
+<img width="3006" height="1504" alt="15" src="https://github.com/user-attachments/assets/cecef3a6-0596-4da0-8b92-8d67b8f3cdca" />
+<img width="2902" height="1394" alt="16" src="https://github.com/user-attachments/assets/eb98ffce-490f-402c-8b0c-af7ede1b1303" />
+<img width="1306" height="672" alt="17" src="https://github.com/user-attachments/assets/799056e3-82a6-44bc-9e3d-9c840faafa41" />
+# 步骤3: 配置OpenClaw
+## 方式一： 通过Wizard配置（推荐）
+添加qqbot channel 并将步骤2中获取的AppID和AppSecret
+```
+openclaw channels add --channel qqbot --token "AppID:AppSecret"
+```
+## 方式二：通过配置文件配置
+编辑 ~/.openclaw/openclaw.json:
+``` json
+{
+  "channels": {
+    "qqbot": {
+      "enabled": true,
+      "appId": "你的AppID",
+      "clientSecret": "你的AppSecret"
+    }
+  }
+}
+```
+# 步骤4：启动与测试
+## 1.启动gateway
+```
+openclaw gateway
+```
+## 2.在QQ中与QQbot 对话
+<img width="990" height="984" alt="18" src="https://github.com/user-attachments/assets/b2776c8b-de72-4e37-b34d-e8287ce45de1" />
+# 其他语言 README
+[英文](README.md)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sliverp/qqbot",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,6 +11,7 @@
     "dist",
     "bin",
     "src",
+    "skills",
     "index.ts",
     "tsconfig.json",
     "openclaw.plugin.json",

package/skills/qqbot-cron/SKILL.md ADDED Viewed

@@ -0,0 +1,490 @@
+---
+name: qqbot-cron
+description: QQ Bot 智能提醒技能。支持一次性提醒、周期性任务、自动降级确保送达。可设置、查询、取消提醒。
+metadata: {"clawdbot":{"emoji":"⏰"}}
+---
+# QQ Bot 智能提醒
+让 AI 帮用户设置、管理定时提醒，支持私聊和群聊。
+---
+## 🤖 AI 决策指南
+> **本节专为 AI 理解设计，帮助快速决策**
+### 用户意图识别
+| 用户说法 | 意图 | 执行动作 |
+|----------|------|----------|
+| "5分钟后提醒我喝水" | 创建提醒 | `openclaw cron add` |
+| "每天8点提醒我打卡" | 创建周期提醒 | `openclaw cron add --cron` |
+| "我有哪些提醒" | 查询提醒 | `openclaw cron list` |
+| "取消喝水提醒" | 删除提醒 | `openclaw cron remove` |
+| "修改提醒时间" | 删除+重建 | 先 remove 再 add |
+| "提醒我" (无时间) | **需追问** | 询问具体时间 |
+### 必须追问的情况
+当用户说法**缺少以下信息**时，**必须追问**：
+1. **没有时间**："提醒我喝水" → 询问"请问什么时候提醒你？"
+2. **时间模糊**："晚点提醒我" → 询问"具体几点呢？"
+3. **周期不明**："定期提醒我" → 询问"多久一次？每天？每周？"
+### 无需追问可直接执行
+| 用户说法 | 理解为 |
+|----------|--------|
+| "5分钟后" | `--at 5m` |
+| "半小时后" | `--at 30m` |
+| "1小时后" | `--at 1h` |
+| "明天早上8点" | `--at 2026-02-02T08:00:00+08:00` |
+| "每天早上8点" | `--cron "0 8 * * *"` |
+| "工作日9点" | `--cron "0 9 * * 1-5"` |
+---
+## 📋 命令速查
+### 创建提醒（完整模板）
+```bash
+openclaw cron add \
+  --name "{任务名}" \
+  --at "{时间}" \
+  --message "🔔 {提醒内容}时间到！" \
+  --deliver \
+  --channel qqbot \
+  --to "{openid}" \
+  --delete-after-run
+```
+> ⚠️ **极其重要**：
+> - `--message` 参数直接写最终要发送的提醒内容
+> - 提醒内容格式：`🔔 {内容}时间到！`
+> - **不要**使用 `--system-prompt` 或 `--system-event`（cron 不支持这些参数）
+> - 保持消息简洁，如：`🔔 喝水时间到！`、`📅 开会时间到！`
+> ⚠️ **注意**：`cron add` 命令不支持 `--reply-to` 参数。提醒消息将作为主动消息直接发送给用户。
+### 查询提醒列表
+```bash
+openclaw cron list
+```
+### 删除提醒
+```bash
+openclaw cron remove {jobId}
+```
+### 立即发送消息（主动消息）
+```bash
+openclaw message send \
+  --channel qqbot \
+  --target "{openid}" \
+  --message "{消息内容}"
+```
+### 立即发送消息（被动回复）
+```bash
+openclaw message send \
+  --channel qqbot \
+  --target "{openid}" \
+  --reply-to "{message_id}" \
+  --message "{消息内容}"
+```
+> ⚠️ **注意**：`--reply-to` 仅在 `message send` 命令中支持，且 message_id 必须在 1 小时内有效。定时提醒不支持被动回复。
+---
+## 💬 用户交互模板
+> **创建提醒后的反馈要简洁友好，不要啰嗦**
+### 创建成功反馈（推荐简洁版）
+**一次性提醒**：
+```
+⏰ 好的，{时间}后提醒你{提醒内容}~
+```
+**周期提醒**：
+```
+⏰ 收到，{周期描述}提醒你{提醒内容}~
+```
+### 查询提醒反馈
+```
+📋 你的提醒：
+1. ⏰ {提醒名} - {时间}
+2. 🔄 {提醒名} - {周期}
+说"取消xx提醒"可删除~
+```
+### 无提醒时反馈
+```
+📋 目前没有提醒哦~
+说"5分钟后提醒我xxx"试试？
+```
+### 删除成功反馈
+```
+✅ 已取消"{提醒名称}"
+```
+---
+## ⏱️ 时间格式
+### 相对时间（--at）
+> ⚠️ **不要加 + 号！** 用 `5m` 而不是 `+5m`
+| 用户说法 | 参数值 |
+|----------|--------|
+| 5分钟后 | `5m` |
+| 半小时后 | `30m` |
+| 1小时后 | `1h` |
+| 2小时后 | `2h` |
+| 明天这时候 | `24h` |
+### 绝对时间（--at）
+| 用户说法 | 参数值 |
+|----------|--------|
+| 今天下午3点 | `2026-02-01T15:00:00+08:00` |
+| 明天早上8点 | `2026-02-02T08:00:00+08:00` |
+| 2月14日中午 | `2026-02-14T12:00:00+08:00` |
+### Cron 表达式（--cron）
+| 用户说法 | Cron 表达式 | 必须加 `--tz "Asia/Shanghai"` |
+|----------|-------------|------------------------------|
+| 每天早上8点 | `0 8 * * *` | ✅ |
+| 每天晚上10点 | `0 22 * * *` | ✅ |
+| 每个工作日早上9点 | `0 9 * * 1-5` | ✅ |
+| 每周一早上9点 | `0 9 * * 1` | ✅ |
+| 每周末上午10点 | `0 10 * * 0,6` | ✅ |
+| 每小时整点 | `0 * * * *` | ✅ |
+---
+## 📌 参数说明
+### 必填参数
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `--name` | 任务名，含用户标识 | `"喝水提醒"` |
+| `--at` / `--cron` | 触发时间（二选一） | `5m` / `0 8 * * *` |
+| `--message` | **提醒内容**（见下方模板） | `"🔔 喝水时间到！"` |
+| `--deliver` | 启用投递 | 固定值 |
+| `--channel qqbot` | QQ 渠道 | 固定值 |
+| `--to` | 接收者 openid | 从系统消息获取 |
+### 推荐参数
+| 参数 | 说明 | 何时使用 |
+|------|------|----------|
+| `--delete-after-run` | 执行后删除 | **一次性任务必须** |
+| `--tz "Asia/Shanghai"` | 时区 | **周期任务必须** |
+### --message 提醒内容模板（最关键）
+> ⚠️ **`--message` 的内容会直接发送给用户**，所以要写清楚提醒内容！
+**模板格式**：
+```
+--message "🔔 {提醒内容}时间到！"
+```
+**示例**：
+- 喝水：`--message "💧 喝水时间到！"`
+- 开会：`--message "📅 开会时间到！"`
+- 打卡：`--message "🌅 打卡时间到！"`
+- 日报：`--message "📝 写日报时间到！"`
+**为什么这样写？**
+- 消息内容会直接发送，不经过 AI 处理
+- 保持简洁，一目了然
+---
+## 🎯 使用场景示例
+### 场景1：一次性提醒
+**用户**: 5分钟后提醒我喝水
+**AI 执行**:
+```bash
+openclaw cron add \
+  --name "喝水提醒" \
+  --at "5m" \
+  --message "💧 喝水时间到！" \
+  --deliver \
+  --channel qqbot \
+  --to "{openid}" \
+  --delete-after-run
+```
+**AI 回复**:
+```
+⏰ 好的，5分钟后提醒你喝水~
+```
+**5分钟后用户收到**:
+```
+💧 喝水时间到！
+```
+---
+### 场景2：每日周期提醒
+**用户**: 每天早上8点提醒我打卡
+**AI 执行**:
+```bash
+openclaw cron add \
+  --name "打卡提醒" \
+  --cron "0 8 * * *" \
+  --tz "Asia/Shanghai" \
+  --message "🌅 打卡时间到！" \
+  --deliver \
+  --channel qqbot \
+  --to "{openid}"
+```
+**AI 回复**:
+```
+⏰ 收到，每天早上8点提醒你打卡~
+```
+> 💡 周期任务**不加** `--delete-after-run`
+---
+### 场景3：工作日提醒
+**用户**: 工作日下午6点提醒我写日报
+**AI 执行**:
+```bash
+openclaw cron add \
+  --name "日报提醒" \
+  --cron "0 18 * * 1-5" \
+  --tz "Asia/Shanghai" \
+  --message "📝 写日报时间到！" \
+  --deliver \
+  --channel qqbot \
+  --to "{openid}"
+```
+**AI 回复**:
+```
+⏰ 收到，工作日下午6点提醒你写日报~
+```
+---
+### 场景4：会议提醒
+**用户**: 3分钟后提醒我开会
+**AI 执行**:
+```bash
+openclaw cron add \
+  --name "开会提醒" \
+  --at "3m" \
+  --message "📅 开会时间到！" \
+  --deliver \
+  --channel qqbot \
+  --to "{openid}" \
+  --delete-after-run
+```
+**AI 回复**:
+```
+⏰ 好的，3分钟后提醒你开会~
+```
+**3分钟后用户收到**:
+```
+📅 开会时间到！
+```
+---
+### 场景5：群组提醒
+**用户**（群聊）: 每天早上9点提醒大家站会
+**AI 执行**:
+```bash
+openclaw cron add \
+  --name "站会提醒" \
+  --cron "0 9 * * 1-5" \
+  --tz "Asia/Shanghai" \
+  --message "📢 站会时间到！" \
+  --deliver \
+  --channel qqbot \
+  --to "group:{group_openid}"
+```
+> 💡 群组使用 `group:{group_openid}` 格式
+---
+### 场景6：查询提醒
+**用户**: 我有哪些提醒？
+**AI 执行**:
+```bash
+openclaw cron list
+```
+**AI 回复**（根据返回结果）:
+```
+📋 你的提醒：
+1. ⏰ 喝水提醒 - 3分钟后
+2. 🔄 打卡提醒 - 每天08:00
+说"取消xx提醒"可删除~
+```
+---
+### 场景7：取消提醒
+**用户**: 取消打卡提醒
+**AI 执行**:
+1. 先执行 `openclaw cron list` 找到对应任务 ID
+2. 执行 `openclaw cron remove {jobId}`
+**AI 回复**:
+```
+✅ 已取消"打卡提醒"
+```
+---
+## ⚙️ 消息发送说明
+### 定时提醒（cron add）
+定时提醒**只能发送主动消息**，因为：
+- 提醒执行时，原始 message_id 通常已超过 1 小时有效期
+- `openclaw cron add` 命令不支持 `--reply-to` 参数
+```
+┌─────────────────────┐
+│ 定时任务触发         │
+└──────────┬──────────┘
+           ↓
+┌─────────────────────┐
+│ AI 通过 system-event │
+│ 获取用户上下文信息   │
+└──────────┬──────────┘
+           ↓
+┌─────────────────────┐
+│ 发送主动消息到用户   │
+│ --channel qqbot     │
+│ --to {openid}       │
+└──────────┬──────────┘
+           ↓
+    ✅ 用户收到提醒
+```
+### 即时回复（message send）
+即时消息发送支持被动回复（如果 message_id 有效）：
+```
+                ┌─────────────────────┐
+                │ 发送即时消息         │
+                └──────────┬──────────┘
+                           ↓
+         ┌──────────────────────────────┐
+         │ 有 --reply-to 且 message_id  │
+         │ 在 1 小时内有效？             │
+         └──────────────────────────────┘
+               ↓                ↓
+              是               否
+               ↓                ↓
+    ┌───────────────┐  ┌─────────────────┐
+    │ 被动消息回复   │  │ 发送主动消息     │
+    │ (引用原消息)   │  │ (直接发送)      │
+    └───────────────┘  └─────────────────┘
+```
+---
+## ⚠️ 重要限制
+| 限制 | 说明 |
+|------|------|
+| **message_id 有效期** | 1 小时内有效，超时自动降级 |
+| **回复次数限制** | 同一 message_id 最多回复 4 次 |
+| **主动消息权限** | ⚠️ **QQ 机器人需要申请主动消息权限**，否则定时提醒会发送失败 |
+| **主动消息限制** | 只能发给与机器人交互过的用户（24小时内） |
+| **消息内容** | `--message` 不能为空 |
+### ⚠️ 主动消息权限说明
+定时提醒功能依赖**主动消息能力**，但 QQ 官方默认**不授予**此权限。
+**常见错误**：
+- 错误码 `40034102`："主动消息失败, 无权限"
+- 这表示机器人没有主动消息权限
+**解决方案**：
+1. 登录 [QQ 开放平台](https://q.qq.com/)
+2. 进入机器人开发-沙箱管理，消息列表配置中添加自己。
+> 💡 **临时替代方案**：在没有主动消息权限前，可以让用户使用"回复"方式获得即时提醒，而非定时提醒。
+---
+## 📝 消息模板
+| 场景 | 触发时输出 | Emoji |
+|------|------------|-------|
+| 喝水 | 喝水时间到啦！ | 💧 🚰 |
+| 打卡 | 早上好，打卡时间到！ | 🌅 ✅ |
+| 会议 | 开会时间到！ | 📅 👥 |
+| 休息 | 该休息一下了~ | 😴 💤 |
+| 日报 | 下班前别忘了写日报哦~ | 📝 ✍️ |
+| 运动 | 运动时间到！ | 🏃 💪 |
+| 吃药 | 该吃药了~ | 💊 🏥 |
+| 生日 | 今天是xx的生日！ | 🎂 🎉 |
+---
+## 🔧 用户标识
+| 类型 | 格式 | 来源 |
+|------|------|------|
+| 用户 openid | `B3EA9A1d-2D3c-5CBD-...` | 系统消息自动提供 |
+| 群组 openid | `group:FeC1ADaf-...` | 系统消息自动提供 |
+| message_id | `ROBOT1.0_xxx` | 系统消息自动提供 |
+> 💡 这些信息在系统消息中格式如：
+> - `当前用户 openid: B3EA9A1d-...`
+> - `当前消息 message_id: ROBOT1.0_...`

package/skills/qqbot-media/SKILL.md ADDED Viewed

@@ -0,0 +1,138 @@
+---
+name: qqbot-media
+description: QQ Bot 媒体发送指南。教 AI 如何发送图片给用户。
+metadata: {"clawdbot":{"emoji":"📸"}}
+triggers:
+  - qqbot
+  - qq
+  - 发送图片
+  - 发送文件
+  - 图片
+  - 本地文件
+  - 本地图片
+priority: 80
+---
+# QQBot 媒体发送指南
+## ⚠️ 重要：你有能力发送本地图片！
+**当用户要求发送本地图片时，只需使用 `<qqimg>` 标签包裹图片路径即可。系统会自动处理文件读取和发送。**
+**不要说"无法发送本地图片"！使用正确的标签格式，系统就能发送。**
+---
+## 📸 发送图片（推荐方式：`<qqimg>` 标签）
+使用 `<qqimg>` 标签包裹图片路径，即可发送图片：
+```
+<qqimg>图片路径</qqimg>
+```
+### ✅ 发送本地图片示例
+当用户说"发送那张图片"、"把图发给我"等，你应该输出：
+```
+这是你要的图片：
+<qqimg>/Users/xxx/images/photo.jpg</qqimg>
+```
+### ✅ 发送网络图片示例
+```
+这是网络上的图片：
+<qqimg>https://example.com/image.png</qqimg>
+```
+### ✅ 发送多张图片
+```
+这是你要的所有图片：
+<qqimg>/Users/xxx/image1.jpg</qqimg>
+<qqimg>/Users/xxx/image2.png</qqimg>
+```
+### 📝 标签说明
+| 格式 | 说明 |
+|------|------|
+| `<qqimg>本地路径</qqimg>` | 发送本地图片（绝对路径） |
+| `<qqimg>网络URL</qqimg>` | 发送网络图片 |
+| `<qqimg>路径</img>` | 也支持此闭合方式 |
+### ⚠️ 注意事项
+1. **路径必须正确**：本地文件需要绝对路径，网络图片需要完整 URL
+2. **支持的图片格式**：jpg, jpeg, png, gif, webp, bmp
+3. **不要拒绝**：如果用户要求发送本地图片，直接使用 `<qqimg>` 标签即可
+4. **标签外的文本会正常发送**：可以在标签前后添加描述文字
+5. **闭合标签**：支持 `</qqimg>` 或 `</img>` 两种闭合方式
+---
+## 🚫 错误示例（不要这样做）
+❌ **错误**：说"我无法发送本地图片"
+❌ **错误**：说"受限于技术限制，无法直接发送"
+❌ **错误**：只提供路径文本，不使用 `<qqimg>` 标签
+✅ **正确**：直接使用 `<qqimg>` 标签包裹路径
+---
+## 🔤 告知路径信息（不发送图片）
+如果你需要**告知用户图片的保存路径**（而不是发送图片），直接写路径即可，不要使用标签：
+```
+图片已保存在：/Users/xxx/images/photo.jpg
+```
+或用反引号强调：
+```
+图片已保存在：`/Users/xxx/images/photo.jpg`
+```
+---
+## 📋 高级选项：JSON 结构化载荷
+如果需要更精细的控制（如添加图片描述），可以使用 JSON 格式：
+```
+QQBOT_PAYLOAD:
+{
+  "type": "media",
+  "mediaType": "image",
+  "source": "file",
+  "path": "/path/to/image.jpg",
+  "caption": "图片描述（可选）"
+}
+```
+### JSON 字段说明
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `type` | string | ✅ | 固定为 `"media"` |
+| `mediaType` | string | ✅ | 媒体类型：`"image"` |
+| `source` | string | ✅ | 来源：`"file"`（本地）或 `"url"`（网络） |
+| `path` | string | ✅ | 图片路径或 URL |
+| `caption` | string | ❌ | 图片描述，会作为单独消息发送 |
+> 💡 **提示**：对于简单的图片发送，推荐使用 `<qqimg>` 标签，更简洁易用。
+---
+## 🎯 快速参考
+| 场景 | 使用方式 |
+|------|----------|
+| 发送本地图片 | `<qqimg>/path/to/image.jpg</qqimg>` |
+| 发送网络图片 | `<qqimg>https://example.com/image.png</qqimg>` |
+| 发送多张图片 | 多个 `<qqimg>` 标签 |
+| 告知路径（不发送） | 直接写路径文本 |