@tencent-connect/openclaw-qqbot 1.6.6-alpha.4 → 1.6.6

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 (3) hide show
  1. package/README.md +19 -15
  2. package/README.zh.md +19 -15
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
 
11
11
  **Connect your AI assistant to QQ — private chat, group chat, and rich media, all in one plugin.**
12
12
 
13
- ### 🚀 Current Version: `v1.6.5`
13
+ ### 🚀 Current Version: `v1.6.6`
14
14
 
15
15
  [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
16
16
  [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
@@ -25,7 +25,7 @@
25
25
 
26
26
  Scan to join the QQ group chat
27
27
 
28
- <img width="400" alt="QQ QR Code" src="./docs/images/developer_group.png" />
28
+ <img width="400" alt="QQ QR Code" src="./docs/images/developer-group.png" />
29
29
 
30
30
 
31
31
  </div>
@@ -61,7 +61,7 @@ QQ quote events carry index keys (e.g. `REFIDX_xxx`) instead of full original me
61
61
  - Store path: `~/.openclaw/qqbot/data/ref-index.jsonl` (survives gateway restart).
62
62
  - Quote body may include text + media summary (image/voice/video/file).
63
63
 
64
- <img width="360" src="docs/images/ref_msg.png" alt="Quoted Message Context Demo" />
64
+ <img width="360" src="docs/images/ref-msg.png" alt="Quoted Message Context Demo" />
65
65
 
66
66
  ### 🎙️ Voice Messages (STT)
67
67
 
@@ -71,7 +71,7 @@ With STT configured, the plugin automatically transcribes voice messages to text
71
71
  >
72
72
  > **QQBot**: Tomorrow (March 7, Saturday) Shenzhen weather forecast 🌤️ ...
73
73
 
74
- <img width="360" src="docs/images/fc7b2236896cfba3a37c94be5d59ce3e_720.jpg" alt="Voice STT Demo" />
74
+ <img width="360" src="docs/images/voice-stt.jpg" alt="Voice STT Demo" />
75
75
 
76
76
  ### 📄 File Understanding
77
77
 
@@ -81,7 +81,7 @@ Send any file to the bot — novels, reports, spreadsheets — AI automatically
81
81
  >
82
82
  > **QQBot**: Got it! You uploaded the Chinese version of "War and Peace" by Leo Tolstoy. This appears to be the opening of Chapter 1...
83
83
 
84
- <img width="360" src="docs/images/07bff56ab68e03173d2af586eeb3bcee_720.jpg" alt="File Understanding Demo" />
84
+ <img width="360" src="docs/images/file-understand.jpg" alt="File Understanding Demo" />
85
85
 
86
86
  ### 🖼️ Image Understanding
87
87
 
@@ -91,7 +91,7 @@ If your main model supports vision (e.g. Tencent Hunyuan `hunyuan-vision`), AI c
91
91
  >
92
92
  > **QQBot**: Haha, so cute! Is that a QQ penguin in a lobster costume? 🦞🐧 ...
93
93
 
94
- <img width="360" src="docs/images/59d421891f813b0d3c0cbe12574b6a72_720.jpg" alt="Image Understanding Demo" />
94
+ <img width="360" src="docs/images/image-understand.jpg" alt="Image Understanding Demo" />
95
95
 
96
96
  ### 🎨 Image Sending
97
97
 
@@ -101,7 +101,7 @@ If your main model supports vision (e.g. Tencent Hunyuan `hunyuan-vision`), AI c
101
101
 
102
102
  AI can send images directly. Supports local paths and URLs. Formats: jpg/png/gif/webp/bmp.
103
103
 
104
- <img width="360" src="docs/images/4645f2b3a20822b7f8d6664a708529eb_720.jpg" alt="Image Generation Demo" />
104
+ <img width="360" src="docs/images/image-send.jpg" alt="Image Generation Demo" />
105
105
 
106
106
  ### 🔊 Voice Sending
107
107
 
@@ -111,7 +111,7 @@ AI can send images directly. Supports local paths and URLs. Formats: jpg/png/gif
111
111
 
112
112
  AI can send voice messages directly. Formats: mp3/wav/silk/ogg. No ffmpeg required.
113
113
 
114
- <img width="360" src="docs/images/21dce8bfc553ce23d1bd1b270e9c516c.jpg" alt="TTS Voice Demo" />
114
+ <img width="360" src="docs/images/voice-send.jpg" alt="TTS Voice Demo" />
115
115
 
116
116
  ### ⏰ Scheduled Reminder (Proactive Message)
117
117
 
@@ -129,9 +129,13 @@ This capability depends on OpenClaw cron scheduling and proactive messaging. If
129
129
  >
130
130
  > **QQBot**: *(sends a .txt file)*
131
131
 
132
- AI can send files directly. Any format, up to 20MB.
132
+ AI can send files directly, in any format.
133
133
 
134
- <img width="360" src="docs/images/17cada70df90185d45a2d6dd36e92f2f_720.jpg" alt="File Sending Demo" />
134
+ <img width="360" src="docs/images/file-send.jpg" alt="File Sending Demo" />
135
+
136
+ Since v1.6.6, large file transfer is supported: images up to 20MB, videos up to 30MB, attachments up to 100MB, with a daily transfer limit of 2GB.
137
+
138
+ <img width="360" src="docs/images/large-file-transfer.jpg" alt="Large File Transfer Demo" />
135
139
 
136
140
  ### 🎬 Video Sending
137
141
 
@@ -141,7 +145,7 @@ AI can send files directly. Any format, up to 20MB.
141
145
 
142
146
  AI can send videos directly. Supports local files and URLs.
143
147
 
144
- <img width="360" src="docs/images/85d03b8a216f267ab7b2aee248a18a41_720.jpg" alt="Video Sending Demo" />
148
+ <img width="360" src="docs/images/video-send.jpg" alt="Video Sending Demo" />
145
149
 
146
150
  > **Under the hood:** Upload dedup caching, ordered queue delivery, and multi-layer audio format fallback.
147
151
 
@@ -220,15 +224,15 @@ All commands support a `?` suffix to show usage:
220
224
  2. After scanning, tap **Agree** on your phone — you'll land on the bot configuration page.
221
225
  3. Click **Create Bot** to create a new QQ bot.
222
226
 
223
- <img width="720" alt="Create Bot" src="docs/images/create_robot.png" />
227
+ <img width="720" alt="Create Bot" src="docs/images/create-robot.png" />
224
228
 
225
229
  > ⚠️ The bot will automatically appear in your QQ message list and send a first message. However, it will reply "The bot has gone to Mars" until you complete the configuration steps below.
226
230
 
227
- <img width="400" alt="Bot Say Hello" src="docs/images/bot_say_hello.jpg" />
231
+ <img width="400" alt="Bot Say Hello" src="docs/images/bot-say-hello.jpg" />
228
232
 
229
233
  4. Find **AppID** and **AppSecret** on the bot's page, click **Copy** for each, and save them somewhere safe (e.g., a notepad). **AppSecret is not stored in plaintext — if you leave the page without saving it, you'll have to regenerate a new one.**
230
234
 
231
- <img width="720" alt="Find AppID and AppSecret" src="docs/images/find_appid_secret.png" />
235
+ <img width="720" alt="Find AppID and AppSecret" src="docs/images/find-appid-secret.png" />
232
236
 
233
237
  > For a step-by-step walkthrough with screenshots, see the [official guide](https://cloud.tencent.com/developer/article/2626045).
234
238
 
@@ -458,7 +462,7 @@ Special thanks to [@sliverp](https://github.com/sliverp) for outstanding contrib
458
462
  Thanks to [Tencent Cloud Lighthouse](https://cloud.tencent.com/product/lighthouse) for the deep collaboration. For raising crawfish, choose Tencent Cloud Lighthouse!
459
463
 
460
464
  <a href="https://cloud.tencent.com/product/lighthouse">
461
- <img alt="Tencent Cloud Lighthouse" src="./docs/images/lighthouse_head.png" height="500" style="max-width:80%; height:auto;"/>
465
+ <img alt="Tencent Cloud Lighthouse" src="./docs/images/lighthouse-head.png" height="500" style="max-width:80%; height:auto;"/>
462
466
  </a>
463
467
 
464
468
  ## ⭐ Star History
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@
9
9
 
10
10
  **让你的 AI 助手接入 QQ — 私聊、群聊、富媒体,一个插件全搞定。**
11
11
 
12
- ### 🚀 当前版本: `v1.6.5`
12
+ ### 🚀 当前版本: `v1.6.6`
13
13
 
14
14
  [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
15
15
  [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
@@ -21,7 +21,7 @@
21
21
 
22
22
  扫描二维码加入群聊,一起交流
23
23
 
24
- <img width="400" alt="QQ 群二维码" src="./docs/images/developer_group.png" />
24
+ <img width="400" alt="QQ 群二维码" src="./docs/images/developer-group.png" />
25
25
 
26
26
  </div>
27
27
 
@@ -56,7 +56,7 @@ QQ 的引用事件通常只携带索引键(如 `REFIDX_xxx`),不直接返
56
56
  - 存储位置:`~/.openclaw/qqbot/data/ref-index.jsonl`(网关重启后仍可恢复)。
57
57
  - 引用内容支持文本 + 媒体摘要(图片/语音/视频/文件)。
58
58
 
59
- <img width="360" src="docs/images/ref_msg.png" alt="引用消息上下文演示" />
59
+ <img width="360" src="docs/images/ref-msg.png" alt="引用消息上下文演示" />
60
60
 
61
61
  ### 🎙️ 语音消息(STT)
62
62
 
@@ -66,7 +66,7 @@ QQ 的引用事件通常只携带索引键(如 `REFIDX_xxx`),不直接返
66
66
  >
67
67
  > **QQBot**:明天(3月7日 周六)深圳的天气预报 🌤️ ...
68
68
 
69
- <img width="360" src="docs/images/fc7b2236896cfba3a37c94be5d59ce3e_720.jpg" alt="听语音演示" />
69
+ <img width="360" src="docs/images/voice-stt.jpg" alt="听语音演示" />
70
70
 
71
71
  ### 📄 文件理解
72
72
 
@@ -76,7 +76,7 @@ QQ 的引用事件通常只携带索引键(如 `REFIDX_xxx`),不直接返
76
76
  >
77
77
  > **QQBot**:收到!你上传了列夫·托尔斯泰的《战争与和平》中文版文本。从内容来看,这是第一章的开头……你想让我做什么?
78
78
 
79
- <img width="360" src="docs/images/07bff56ab68e03173d2af586eeb3bcee_720.jpg" alt="AI理解用户发送的文件" />
79
+ <img width="360" src="docs/images/file-understand.jpg" alt="AI理解用户发送的文件" />
80
80
 
81
81
  ### 🖼️ 图片理解
82
82
 
@@ -86,7 +86,7 @@ QQ 的引用事件通常只携带索引键(如 `REFIDX_xxx`),不直接返
86
86
  >
87
87
  > **QQBot**:哈哈,好可爱!这是QQ企鹅穿上小龙虾套装吗?🦞🐧 ...
88
88
 
89
- <img width="360" src="docs/images/59d421891f813b0d3c0cbe12574b6a72_720.jpg" alt="图片理解演示" />
89
+ <img width="360" src="docs/images/image-understand.jpg" alt="图片理解演示" />
90
90
 
91
91
  ### 🎨 图片发送
92
92
 
@@ -96,7 +96,7 @@ QQ 的引用事件通常只携带索引键(如 `REFIDX_xxx`),不直接返
96
96
 
97
97
  AI 可直接发送图片,支持本地文件路径和网络 URL。格式:jpg/png/gif/webp/bmp。
98
98
 
99
- <img width="360" src="docs/images/4645f2b3a20822b7f8d6664a708529eb_720.jpg" alt="发图片演示" />
99
+ <img width="360" src="docs/images/image-send.jpg" alt="发图片演示" />
100
100
 
101
101
  ### 🔊 语音发送
102
102
 
@@ -106,7 +106,7 @@ AI 可直接发送图片,支持本地文件路径和网络 URL。格式:jpg/
106
106
 
107
107
  AI 可直接发送语音消息。格式:mp3/wav/silk/ogg,无需安装 ffmpeg。
108
108
 
109
- <img width="360" src="docs/images/21dce8bfc553ce23d1bd1b270e9c516c.jpg" alt="发语音演示" />
109
+ <img width="360" src="docs/images/voice-send.jpg" alt="发语音演示" />
110
110
 
111
111
  ### ⏰ 定时提醒(主动消息)
112
112
 
@@ -124,9 +124,13 @@ AI 可直接发送语音消息。格式:mp3/wav/silk/ogg,无需安装 ffmpeg
124
124
  >
125
125
  > **QQBot**:*(发送 .txt 文件)*
126
126
 
127
- AI 可直接发送文件。任意格式,最大 20MB。
127
+ AI 可直接发送文件,任意格式均可。
128
128
 
129
- <img width="360" src="docs/images/17cada70df90185d45a2d6dd36e92f2f_720.jpg" alt="发文件演示" />
129
+ <img width="360" src="docs/images/file-send.jpg" alt="发文件演示" />
130
+
131
+ v1.6.6 起支持大文件传输:图片最大 20MB,视频最大 30MB,附件最大 100MB,每日累计传输上限 2GB。
132
+
133
+ <img width="360" src="docs/images/large-file-transfer.jpg" alt="大文件传输演示" />
130
134
 
131
135
  ### 🎬 视频发送
132
136
 
@@ -136,7 +140,7 @@ AI 可直接发送文件。任意格式,最大 20MB。
136
140
 
137
141
  AI 可直接发送视频,支持本地文件和公网 URL。
138
142
 
139
- <img width="360" src="docs/images/85d03b8a216f267ab7b2aee248a18a41_720.jpg" alt="发视频演示" />
143
+ <img width="360" src="docs/images/video-send.jpg" alt="发视频演示" />
140
144
 
141
145
  > **底层细节:** 上传去重缓存、有序队列发送、音频格式多层降级。
142
146
 
@@ -215,15 +219,15 @@ AI 可直接发送视频,支持本地文件和公网 URL。
215
219
  2. 手机 QQ 扫码后选择**同意**,即完成注册,进入 QQ 机器人配置页。
216
220
  3. 点击**创建机器人**,即可直接新建一个 QQ 机器人。
217
221
 
218
- <img width="720" alt="创建机器人" src="docs/images/create_robot.png" />
222
+ <img width="720" alt="创建机器人" src="docs/images/create-robot.png" />
219
223
 
220
224
  > ⚠️ 机器人创建后会自动出现在你的 QQ 消息列表中,并发送第一条消息。但在完成下面的配置之前,发消息会提示"该机器人去火星了",属于正常现象。
221
225
 
222
- <img width="400" alt="机器人打招呼" src="docs/images/bot_say_hello.jpg" />
226
+ <img width="400" alt="机器人打招呼" src="docs/images/bot-say-hello.jpg" />
223
227
 
224
228
  4. 在机器人页面中找到 **AppID** 和 **AppSecret**,分别点击右侧**复制**按钮,保存到记事本或备忘录中。**AppSecret 不支持明文保存,离开页面后再查看会强制重置,请务必妥善保存。**
225
229
 
226
- <img width="720" alt="找到 AppID 和 AppSecret" src="docs/images/find_appid_secret.png" />
230
+ <img width="720" alt="找到 AppID 和 AppSecret" src="docs/images/find-appid-secret.png" />
227
231
 
228
232
  > 详细图文教程请参阅 [官方指南](https://cloud.tencent.com/developer/article/2626045)。
229
233
 
@@ -453,7 +457,7 @@ STT 支持两级配置,按优先级查找:
453
457
  感谢[腾讯云Lighthouse](https://cloud.tencent.com/product/lighthouse)的深度合作,养小龙虾,首选腾讯云Lighthouse!
454
458
 
455
459
  <a href="https://cloud.tencent.com/product/lighthouse">
456
- <img alt="腾讯云 Lighthouse" src="./docs/images/lighthouse_head.png" height="500" style="max-width:80%; height:auto;"/>
460
+ <img alt="腾讯云 Lighthouse" src="./docs/images/lighthouse-head.png" height="500" style="max-width:80%; height:auto;"/>
457
461
  </a>
458
462
 
459
463
  ## ⭐ Star History
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tencent-connect/openclaw-qqbot",
3
- "version": "1.6.6-alpha.4",
3
+ "version": "1.6.6",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",