From 2c061465395dbb8b2795ee67a791506e59764988 Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 10:52:40 +0800 Subject: [PATCH 1/9] Rename README.md to README.bak.md --- README.md => README.bak.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README.md => README.bak.md (100%) diff --git a/README.md b/README.bak.md similarity index 100% rename from README.md rename to README.bak.md From 2d4db470eb5e06013b60cf607df5865ec5243f18 Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 11:16:43 +0800 Subject: [PATCH 2/9] Add QQ Open Platform registration and bot setup guide Added detailed instructions for registering a QQ Open Platform account, creating a QQBot, and configuring sandbox settings. --- README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..4073dac --- /dev/null +++ b/README.md @@ -0,0 +1,57 @@ +# 注册QQ开放平台 +前往腾讯QQ开放平台官网，默认无法使用您的QQ账号直接登录，需要新注册QQ开放平台账号。 +1 + +首次注册之后，可以按照QQ开放平台的指引设置超级管理员。 + +2 +手机QQ扫码成功后，继续下一步填写主体相关信息。 + +此处以“个人”为例，按照指引依次输入姓名、身份证号、手机号、验证码，点击继续进入下一步人脸认证。 +3 + +使用手机QQ扫码进行人脸认证。 +4 + +人脸识别审核通过后，即可登录进入QQ开放平台。 +5 + +# 创建一个QQBot机器人 +在QQ开放平台的QQ机器人页面，可以创建机器人。 +6 +7 + +QQ机器人创建完成之后，可选择机器人点击进入管理页面。 +8 + +在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“为OpenClaw配置QQ机器人AppID和AppSecret”步骤中需要使用。 + +注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。 +9 +10 + +# 沙箱配置 +在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。 + +您可以按照自己的使用场景进行配置，也可以完成后续步骤之后再回到本步骤进行操作。 + +⚠️ 注意： +此处已创建的QQ机器人无需进行发布上架对所有QQ用户公开使用，在开发者私人的（沙箱）调试下使用体验即可。 +QQ开放平台不支持机器人的“在QQ群配置”操作，只支持单独和QQ机器人聊天。 +11 + +注意：选择“在消息列表配置”时，需要先添加成员，再通过该成员的QQ扫码来添加机器人。 +12 +此处注意添加成员成功之后，还需要使用QQ扫码添加 + +13 +此时您的QQ账号添加机器人之后，还不能与该机器人正常进行对话，会提示“该机器人去火星了，稍后再试吧”，因为QQ机器人此时尚未与OpenClaw应用打通。 + +您需要继续后面的步骤，为OpenClaw应用配置QQ机器人的AppID和AppSecret。 + +14 + +（可选）您也可以参考前述步骤添加更多成员：首先在成员管理页面中添加新成员，然后在沙箱配置页面中添加成员，之后新成员即可通过QQ扫码添加该QQ机器人。 +15 +16 +17 From 29f3dc70589676a205e67b5034fd32d9bd7b475d Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 11:17:04 +0800 Subject: [PATCH 3/9] Add Chinese translation of README --- README.md => README.zh.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README.md => README.zh.md (100%) diff --git a/README.md b/README.zh.md similarity index 100% rename from README.md rename to README.zh.md From f5a414dda63c204205209fb8bdc2eb2c89e51d11 Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 11:30:51 +0800 Subject: [PATCH 4/9] Update README.zh.md with QQ details and plugin install Added information about QQ and installation instructions for QQ Bot plugin. --- README.zh.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.zh.md b/README.zh.md index 4073dac..3de3af3 100644 --- a/README.zh.md +++ b/README.zh.md @@ -1,3 +1,23 @@ +# QQ +QQ 是一款覆盖广泛用户群体的即时通讯平台，提供文字、语音、图片、文件等多种沟通能力，并支持群聊、频道等协作场景，适用于个人交流与团队协同。 + +该接入方式可将 OpenClaw 与 QQ Bot 进行连接，通过平台的长连接事件订阅机制接收消息与事件回调，从而在不对外暴露公网 Webhook 地址的情况下实现稳定、安全的消息收发与自动化能力集成。 + +# QQ Bot插件安装 +安装 QQ Bot插件: + +OpenClaw plugins命令安装 + +```openclaw plugins install @sliverp/qqbot@latest``` + +使用源码安装： + +``` +git clone https://github.com/sliverp/qqbot.git && cd qqbot +clawdbot plugins install . +``` + + # 注册QQ开放平台 前往腾讯QQ开放平台官网，默认无法使用您的QQ账号直接登录，需要新注册QQ开放平台账号。 1 From f0568ba18b43756ab72c3771b36bae3c8ac6faec Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 11:43:36 +0800 Subject: [PATCH 5/9] Update README.zh.md --- README.zh.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/README.zh.md b/README.zh.md index 3de3af3..6ef978f 100644 --- a/README.zh.md +++ b/README.zh.md @@ -3,8 +3,7 @@ QQ 是一款覆盖广泛用户群体的即时通讯平台，提供文字、语 该接入方式可将 OpenClaw 与 QQ Bot 进行连接，通过平台的长连接事件订阅机制接收消息与事件回调，从而在不对外暴露公网 Webhook 地址的情况下实现稳定、安全的消息收发与自动化能力集成。 -# QQ Bot插件安装 -安装 QQ Bot插件: +# 步骤1:安装QQ Bot插件 OpenClaw plugins命令安装 @@ -17,8 +16,8 @@ git clone https://github.com/sliverp/qqbot.git && cd qqbot clawdbot plugins install . ``` - -# 注册QQ开放平台 +# 步骤2:创建QQ Bot +## 1.注册QQ开放平台 前往腾讯QQ开放平台官网，默认无法使用您的QQ账号直接登录，需要新注册QQ开放平台账号。 1 @@ -36,7 +35,7 @@ clawdbot plugins install . 人脸识别审核通过后，即可登录进入QQ开放平台。 5 -# 创建一个QQBot机器人 +## 2.创建一个QQBot机器人 在QQ开放平台的QQ机器人页面，可以创建机器人。 6 7 @@ -50,7 +49,7 @@ QQ机器人创建完成之后，可选择机器人点击进入管理页面。 9 10 -# 沙箱配置 +## 3.沙箱配置 在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。 您可以按照自己的使用场景进行配置，也可以完成后续步骤之后再回到本步骤进行操作。 @@ -75,3 +74,6 @@ QQ开放平台不支持机器人的“在QQ群配置”操作，只支持单独 15 16 17 + +# 步骤3:配置OpenClaw + From 272c1d897af6b0a016b1dfa477f6d52cd43e3087 Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 11:55:56 +0800 Subject: [PATCH 6/9] Update installation and configuration steps in README --- README.zh.md | 42 ++++++++++++++++++++++++++++++++++++++---- 1 file changed, 38 insertions(+), 4 deletions(-) diff --git a/README.zh.md b/README.zh.md index 6ef978f..eae7bf1 100644 --- a/README.zh.md +++ b/README.zh.md @@ -7,13 +7,15 @@ QQ 是一款覆盖广泛用户群体的即时通讯平台，提供文字、语 OpenClaw plugins命令安装 -```openclaw plugins install @sliverp/qqbot@latest``` +``` +openclaw plugins install @sliverp/qqbot@latest +``` 使用源码安装： ``` git clone https://github.com/sliverp/qqbot.git && cd qqbot -clawdbot plugins install . +openclaw plugins install . ``` # 步骤2:创建QQ Bot @@ -43,7 +45,7 @@ clawdbot plugins install . QQ机器人创建完成之后，可选择机器人点击进入管理页面。 8 -在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“为OpenClaw配置QQ机器人AppID和AppSecret”步骤中需要使用。 +在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“步骤3中配置OpenClaw“中需要使用。 注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。 9 @@ -75,5 +77,37 @@ QQ开放平台不支持机器人的“在QQ群配置”操作，只支持单独 16 17 -# 步骤3:配置OpenClaw +# 步骤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 对话 + +18 From f440a22123493115741044f7df2fc0f46cf1af56 Mon Sep 17 00:00:00 2001 From: Chen Yang Date: Sat, 7 Feb 2026 11:57:31 +0800 Subject: [PATCH 7/9] Rename README.zh.md to README.md --- README.zh.md => README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README.zh.md => README.md (100%) diff --git a/README.zh.md b/README.md similarity index 100% rename from README.zh.md rename to README.md From 32e4a404e7ad2ae0a5458e152a487aedff238adf Mon Sep 17 00:00:00 2001 From: claudechen Date: Sat, 7 Feb 2026 12:18:16 +0800 Subject: [PATCH 8/9] add English README --- README.md | 90 +++++++++++++++++++++------------------- README.zh.md | 113 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 162 insertions(+), 41 deletions(-) create mode 100644 README.zh.md diff --git a/README.md b/README.md index eae7bf1..8d39cb5 100644 --- a/README.md +++ b/README.md @@ -1,113 +1,121 @@ # QQ -QQ 是一款覆盖广泛用户群体的即时通讯平台，提供文字、语音、图片、文件等多种沟通能力，并支持群聊、频道等协作场景，适用于个人交流与团队协同。 -该接入方式可将 OpenClaw 与 QQ Bot 进行连接，通过平台的长连接事件订阅机制接收消息与事件回调，从而在不对外暴露公网 Webhook 地址的情况下实现稳定、安全的消息收发与自动化能力集成。 +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. -# 步骤1:安装QQ Bot插件 +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. -OpenClaw plugins命令安装 +# Step 1: Install the QQ Bot Plugin + +Install via the OpenClaw plugins command. ``` openclaw plugins install @sliverp/qqbot@latest ``` -使用源码安装： +Install from source code: ``` git clone https://github.com/sliverp/qqbot.git && cd qqbot openclaw plugins install . ``` -# 步骤2:创建QQ Bot -## 1.注册QQ开放平台 -前往腾讯QQ开放平台官网，默认无法使用您的QQ账号直接登录，需要新注册QQ开放平台账号。 +# Step 2: Create a QQ Bot + +## 1. Register on the QQ Open Platform + +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. 1 -首次注册之后，可以按照QQ开放平台的指引设置超级管理员。 +After the initial registration, follow the platform's instructions to set up a super administrator. 2 -手机QQ扫码成功后，继续下一步填写主体相关信息。 +After successfully scanning the QR code with your mobile QQ, proceed to the next step to fill in the relevant entity information. -此处以“个人”为例，按照指引依次输入姓名、身份证号、手机号、验证码，点击继续进入下一步人脸认证。 +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. 3 -使用手机QQ扫码进行人脸认证。 +Use your mobile QQ to scan the QR code for facial recognition. 4 -人脸识别审核通过后，即可登录进入QQ开放平台。 +Once the facial recognition review is approved, you can log in to the QQ Open Platform. 5 -## 2.创建一个QQBot机器人 -在QQ开放平台的QQ机器人页面，可以创建机器人。 +## 2. Create a QQ Bot + +On the QQ Open Platform's QQ Bot page, you can create a bot. 6 7 -QQ机器人创建完成之后，可选择机器人点击进入管理页面。 +After the QQ Bot is created, you can select it and click to enter the management page. 8 -在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“步骤3中配置OpenClaw“中需要使用。 +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". -注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。 +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. 9 10 -## 3.沙箱配置 -在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。 +## 3. Sandbox Configuration -您可以按照自己的使用场景进行配置，也可以完成后续步骤之后再回到本步骤进行操作。 +On the QQ Bot's "Development Management" page, in the "Sandbox Configuration" section, set up private chat (select "Configure in Message List"). -⚠️ 注意： -此处已创建的QQ机器人无需进行发布上架对所有QQ用户公开使用，在开发者私人的（沙箱）调试下使用体验即可。 -QQ开放平台不支持机器人的“在QQ群配置”操作，只支持单独和QQ机器人聊天。 +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. 11 -注意：选择“在消息列表配置”时，需要先添加成员，再通过该成员的QQ扫码来添加机器人。 -12 -此处注意添加成员成功之后，还需要使用QQ扫码添加 +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. +12 +Note here that after successfully adding a member, you still need to use QQ scan code to add the bot. 13 -此时您的QQ账号添加机器人之后，还不能与该机器人正常进行对话，会提示“该机器人去火星了，稍后再试吧”，因为QQ机器人此时尚未与OpenClaw应用打通。 +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. -您需要继续后面的步骤，为OpenClaw应用配置QQ机器人的AppID和AppSecret。 +You need to proceed with the following steps to configure the QQ bot's AppID and AppSecret for the OpenClaw application. 14 -（可选）您也可以参考前述步骤添加更多成员：首先在成员管理页面中添加新成员，然后在沙箱配置页面中添加成员，之后新成员即可通过QQ扫码添加该QQ机器人。 +(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. 15 16 17 -# 步骤3: 配置OpenClaw -## 方式一： 通过Wizard配置（推荐） +# Step 3: Configure OpenClaw + +## Method 1: Configure via Wizard (Recommended) + +Add the qqbot channel and input the AppID and AppSecret obtained in Step 2. -添加qqbot channel 并将步骤2中获取的AppID和AppSecret ``` openclaw channels add --channel qqbot --token "AppID:AppSecret" ``` -## 方式二：通过配置文件配置 -编辑 ~/.openclaw/openclaw.json: +## Method 2: Configure via Configuration File + +Edit ~/.openclaw/openclaw.json: + ``` json { "channels": { "qqbot": { "enabled": true, - "appId": "你的AppID", - "clientSecret": "你的AppSecret" + "appId": "Your AppID", + "clientSecret": "Your AppSecret" } } } ``` -# 步骤4：启动与测试 +# Step 4: Start and Test -## 1.启动gateway +## 1. Start the gateway ``` openclaw gateway ``` -## 2.在QQ中与QQbot 对话 +## 2. Chat with the QQbot in QQ 18 - diff --git a/README.zh.md b/README.zh.md new file mode 100644 index 0000000..eae7bf1 --- /dev/null +++ b/README.zh.md @@ -0,0 +1,113 @@ +# 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开放平台账号。 +1 + +首次注册之后，可以按照QQ开放平台的指引设置超级管理员。 + +2 +手机QQ扫码成功后，继续下一步填写主体相关信息。 + +此处以“个人”为例，按照指引依次输入姓名、身份证号、手机号、验证码，点击继续进入下一步人脸认证。 +3 + +使用手机QQ扫码进行人脸认证。 +4 + +人脸识别审核通过后，即可登录进入QQ开放平台。 +5 + +## 2.创建一个QQBot机器人 +在QQ开放平台的QQ机器人页面，可以创建机器人。 +6 +7 + +QQ机器人创建完成之后，可选择机器人点击进入管理页面。 +8 + +在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“步骤3中配置OpenClaw“中需要使用。 + +注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。 +9 +10 + +## 3.沙箱配置 +在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。 + +您可以按照自己的使用场景进行配置，也可以完成后续步骤之后再回到本步骤进行操作。 + +⚠️ 注意： +此处已创建的QQ机器人无需进行发布上架对所有QQ用户公开使用，在开发者私人的（沙箱）调试下使用体验即可。 +QQ开放平台不支持机器人的“在QQ群配置”操作，只支持单独和QQ机器人聊天。 +11 + +注意：选择“在消息列表配置”时，需要先添加成员，再通过该成员的QQ扫码来添加机器人。 +12 +此处注意添加成员成功之后，还需要使用QQ扫码添加 + +13 +此时您的QQ账号添加机器人之后，还不能与该机器人正常进行对话，会提示“该机器人去火星了，稍后再试吧”，因为QQ机器人此时尚未与OpenClaw应用打通。 + +您需要继续后面的步骤，为OpenClaw应用配置QQ机器人的AppID和AppSecret。 + +14 + +（可选）您也可以参考前述步骤添加更多成员：首先在成员管理页面中添加新成员，然后在沙箱配置页面中添加成员，之后新成员即可通过QQ扫码添加该QQ机器人。 +15 +16 +17 + +# 步骤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 对话 + +18 + From de591dc2c7adb57d67f8a486757989a95c9e7b06 Mon Sep 17 00:00:00 2001 From: claudechen Date: Sat, 7 Feb 2026 12:46:54 +0800 Subject: [PATCH 9/9] add multilanguage link --- README.md | 4 ++++ README.zh.md | 2 ++ 2 files changed, 6 insertions(+) diff --git a/README.md b/README.md index 8d39cb5..a4ec2c5 100644 --- a/README.md +++ b/README.md @@ -119,3 +119,7 @@ openclaw gateway ## 2. Chat with the QQbot in QQ 18 + + +# Other Language README +[简体中文](README.zh.md) \ No newline at end of file diff --git a/README.zh.md b/README.zh.md index eae7bf1..4d7920c 100644 --- a/README.zh.md +++ b/README.zh.md @@ -111,3 +111,5 @@ openclaw gateway 18 +# 其他语言 README +[英文](README.md) \ No newline at end of file