@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.
- package/README.md +19 -15
- package/README.zh.md +19 -15
- 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.
|
|
13
|
+
### 🚀 Current Version: `v1.6.6`
|
|
14
14
|
|
|
15
15
|
[](./LICENSE)
|
|
16
16
|
[](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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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
|
|
132
|
+
AI can send files directly, in any format.
|
|
133
133
|
|
|
134
|
-
<img width="360" src="docs/images/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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.
|
|
12
|
+
### 🚀 当前版本: `v1.6.6`
|
|
13
13
|
|
|
14
14
|
[](./LICENSE)
|
|
15
15
|
[](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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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
|
|
127
|
+
AI 可直接发送文件,任意格式均可。
|
|
128
128
|
|
|
129
|
-
<img width="360" src="docs/images/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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
|