Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

Commit 0fc2e3a

Browse files
committed
docs: update WebSocket deployment instructions and reorganize sections in English and Chinese
1 parent bbc6bb0 commit 0fc2e3a

File tree

3 files changed

+33
-7
lines changed

3 files changed

+33
-7
lines changed

.vitepress/config.mjs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,8 @@ export default defineConfig({
8181
link: "/qqofficial",
8282
collapsed: true,
8383
items: [
84+
{ text: "Websockets 方式(推荐)", link: "/qqofficial/websockets" },
8485
{ text: "Webhook 方式", link: "/qqofficial/webhook" },
85-
{ text: "Websockets 方式", link: "/qqofficial/websockets" },
8686
],
8787
},
8888
{
@@ -320,8 +320,8 @@ export default defineConfig({
320320
link: "/qqofficial",
321321
collapsed: true,
322322
items: [
323-
{ text: "Webhook Method", link: "/qqofficial/webhook" },
324-
{ text: "Websockets Method", link: "/qqofficial/websockets" },
323+
{ text: "Websockets", link: "/qqofficial/websockets" },
324+
{ text: "Webhook", link: "/qqofficial/webhook" },
325325
],
326326
},
327327
{

en/platform/qqofficial/websockets.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,20 @@
1414

1515
Proactive message push: Not supported.
1616

17+
## Quick Deployment Steps
18+
19+
> Updated: `2026/03/06`. This method only supports `private chat`.
20+
21+
1. Open [QQ Open Platform](https://q.qq.com/qqbot/openclaw/). Register an account if you don't have one.
22+
2. Click the `Create Bot` button on the right.
23+
3. Obtain your `AppID` and `AppSecret`.
24+
4. In AstrBot WebUI, click `Bots` in the left sidebar, then click `+ Create Bot`, select `QQ Official Bot (WebSocket)`, paste the `AppID` and `AppSecret` into the form, click `Enable`, then click `Save`.
25+
5. Back on the QQ Open Platform page, click `Scan QR Code to Chat` next to your bot, then scan with your mobile QQ to start chatting.
26+
27+
To use the bot in group chats, refer to the `Allow Bot in Channel / Group / Private Chat` section below.
28+
29+
---
30+
1731
## Apply for a Bot
1832

1933
> [!WARNING]

zh/platform/qqofficial/websockets.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,14 +15,26 @@
1515

1616
主动消息推送:不支持。
1717

18+
## 快速部署通道
19+
20+
> 更新自: `2026/03/06`。该方法仅支持 `私聊`
21+
22+
1. 打开 [QQ 开放平台](https://q.qq.com/qqbot/openclaw/)。如果没注册,需要先注册。
23+
2. 点击右侧 `创建机器人` 按钮。
24+
3. 获取 `AppID``AppSecret`
25+
4. 进入 AstrBot 的 WebUI,点击左边栏 `机器人`,然后在右边的界面中,点击 `+ 创建机器人`,选择 `QQ 官方机器人(WebSocket)`,将之前得到的的 `AppID``AppSecret` 复制到这里的表单中,然后 `启用`,然后点击保存。
26+
5. 回到 QQ 开放平台页面,点击机器人右边的 `扫码聊天`。用手机 QQ 扫码即可聊天。
27+
28+
如果要在群聊中使用,参考下面文档的 `允许机器人加入频道/群/私聊` 一节。
29+
30+
---
31+
1832
## 申请一个机器人
1933

2034
> [!WARNING]
2135
>
2236
> 1. 截至目前,QQ 官方机器人需要设置 IP 白名单。
2337
> 2. 支持群聊、私聊、频道聊天、频道私聊。
24-
>
25-
> 由于腾讯即将终止对 Websockets 接入的支持,目前不再推荐使用此方式部署机器人,请使用 [Webhook](/deploy/platform/qqofficial/webhook) 方式。
2638
2739
首先,打开 [QQ官方机器人](https://q.qq.com) 并登录。
2840

@@ -46,7 +58,7 @@
4658

4759
点击 `开发->开发设置`,找到 appid、secret。复制并保存它们。
4860

49-
## 添加 IP 白名单
61+
## 添加 IP 白名单(可选)
5062

5163
点击 `开发->开发设置`,找到 IP 白名单。添加你的服务器 IP 地址。
5264

@@ -62,7 +74,7 @@
6274
1. 进入 AstrBot 的管理面板
6375
2. 点击左边栏 `机器人`
6476
3. 然后在右边的界面中,点击 `+ 创建机器人`
65-
4. 选择 `qq_official`
77+
4. 选择 `QQ 官方机器人(WebSocket)`
6678

6779
弹出的配置项填写:
6880

0 commit comments

Comments
 (0)