208 lines
6.7 KiB
Markdown
208 lines
6.7 KiB
Markdown
---
|
||
title: "WorkBuddy 接入 QQ 指南 | 腾讯云代码助手 CodeBuddy – AI 代码编辑器"
|
||
source: "https://www.codebuddy.cn/docs/workbuddy/QQ-Guide"
|
||
author:
|
||
published: 2026-03-09
|
||
created: 2026-03-11
|
||
description: "腾讯云 CodeBuddy 是新一代 AI 代码编辑器。提供代码补全、错误诊断、技术问答、性能优化等服务,支持主流编程语言,提升编码效率90%,降低代码错误率35%,适用于企业级应用开发和教学实践。"
|
||
tags:
|
||
- "clippings"
|
||
---
|
||
## WorkBuddy 接入 QQ 指南
|
||
|
||
本指南将帮助您将 WorkBuddy 接入 QQ,让您可以通过 QQ 随时随地远程操控电脑上的 WorkBuddy 完成任务。
|
||
|
||
## 前提条件
|
||
|
||
在开始之前,请确保您已满足以下条件:
|
||
|
||
- 已在电脑上安装 WorkBuddy,并开启了 Claw 远程控制功能
|
||
- 拥有一个已完成实名认证的 QQ 账号
|
||
|
||
提示
|
||
|
||
QQ 开放平台要求账号完成实名认证。如未认证,请先在 QQ 中完成实名认证后再进行后续操作。
|
||
|
||
## 1\. 注册 QQ 开放平台账号
|
||
|
||
如果您是首次使用 QQ 开放平台,需要先完成账号注册和入驻。
|
||
|
||
### 1.1 访问开放平台
|
||
|
||
打开浏览器,访问 [QQ 开放平台](https://q.qq.com/#/) ,点击注册或登录。
|
||
|
||

|
||
|
||
### 1.2 设置超级管理员
|
||
|
||
按照页面提示,为平台设置超级管理员。您可以设置自己或其他人为管理员。
|
||
|
||

|
||
|
||
### 1.3 填写主体信息
|
||
|
||
根据您的实际情况,选择主体类型(企业、个体户或个人)并填写相关信息。以下以个人开发者为例:
|
||
|
||

|
||
|
||
### 1.4 完成入驻
|
||
|
||
提交信息后,完成审核和人脸识别验证,即可成功入驻 QQ 开放平台。
|
||
|
||

|
||
|
||
## 2\. 创建 QQ 机器人
|
||
|
||
### 2.1 登录开放平台
|
||
|
||
使用已注册的账号扫码登录 [QQ 开放平台](https://q.qq.com/#/) 。
|
||
|
||
### 2.2 选择创建机器人
|
||
|
||
在资源类型选择页面,点击「机器人」选项。
|
||
|
||

|
||
|
||
### 2.3 填写机器人信息
|
||
|
||
填写机器人的基本信息:
|
||
|
||
| 配置项 | 说明 |
|
||
| --- | --- |
|
||
| **名称** | 机器人的显示名称,建议不要包含特殊符号 |
|
||
| **头像** | 上传一个机器人头像 |
|
||
| **描述** | 简单描述机器人的功能 |
|
||
|
||

|
||
|
||
### 2.4 提交审核
|
||
|
||
确认信息无误后,点击提交。
|
||
|
||
注意
|
||
|
||
机器人名称中不要包含特殊符号,否则可能导致创建失败。
|
||
|
||

|
||
|
||
### 2.5 等待审核通过
|
||
|
||
提交后,机器人会出现在您的应用列表中,等待审核通过即可使用。
|
||
|
||

|
||
|
||
## 3\. 获取应用凭证
|
||
|
||
### 3.1 进入机器人配置页面
|
||
|
||
审核通过后,点击机器人图标进入配置页面。
|
||
|
||

|
||
|
||
### 3.2 获取 AppID 和 AppSecret
|
||
|
||
1. 在左侧菜单中点击「开发管理」
|
||
2. 复制页面上显示的 **AppID**
|
||
3. 点击 AppSecret 旁边的「生成」按钮,获取密钥
|
||
|
||

|
||
|
||
重要提示
|
||
|
||
- AppSecret 只会显示一次,请务必立即保存
|
||
- 如果忘记 AppSecret,需要重新生成,之前的密钥会失效
|
||
|
||

|
||
|
||
## 4\. 在 WorkBuddy 中配置 QQ
|
||
|
||
将获取的凭证配置到 WorkBuddy 中:
|
||
|
||
1. 打开 WorkBuddy,进入 **Claw 设置**
|
||
2. 选择 **QQ 集成**
|
||
3. 填入刚才获取的 AppID 和 AppSecret
|
||
4. 点击保存
|
||
|
||
保存成功后,系统会生成 Webhook 地址,用于下一步配置。
|
||
|
||

|
||
|
||
## 5\. 获取并配置 Webhook
|
||
|
||
### 5.1 复制 Webhook 地址
|
||
|
||
在 WorkBuddy 的 Claw 设置中,找到系统生成的 Webhook 地址,点击复制。
|
||
|
||

|
||
|
||
### 5.2 配置 QQ 机器人回调地址
|
||
|
||
1. 返回 [QQ 机器人后台](https://q.qq.com/#/apps?tab=1)
|
||
2. 选择需要配置的机器人
|
||
|
||
提示
|
||
|
||
如果您创建了多个机器人,请确保选择正确的机器人进行配置。
|
||
|
||

|
||
|
||
1. 访问 [Webhook 设置页面](https://q.qq.com/qqbot/#/developer/webhook-setting)
|
||
2. 在「请求地址」输入框中粘贴 Webhook 地址
|
||
|
||

|
||
|
||
注意
|
||
|
||
粘贴时需要 **去掉 URL 开头的 `https://`** ,只保留域名和路径部分。
|
||
|
||

|
||
|
||
1. 点击确认保存配置
|
||
|
||
### 5.3 添加消息权限
|
||
|
||
在回调配置页面,勾选所有「单聊」相关的权限,确保机器人能够接收和发送消息。
|
||
|
||

|
||
|
||
## 6\. 开始使用
|
||
|
||
配置完成后,您可以通过以下方式开始使用:
|
||
|
||
### 6.1 进入沙箱测试
|
||
|
||
1. 访问 [沙箱配置页面](https://q.qq.com/qqbot/openclaw/index.html)
|
||
2. 点击「沙箱配置」,然后扫描消息列表配置处的二维码
|
||
|
||

|
||
|
||
### 6.2 与机器人对话
|
||
|
||
在 QQ 中打开与 WorkBuddy 机器人的对话窗口,直接发送您的需求,例如「帮我写一个网页」。
|
||
|
||

|
||
|
||
### 6.3 查看执行结果
|
||
|
||
WorkBuddy 会在电脑上自动执行任务,您可以实时查看执行进度和结果。
|
||
|
||
恭喜
|
||
|
||
您已成功将 WorkBuddy 接入 QQ!现在可以通过 QQ 随时随地远程控制 WorkBuddy 完成各种编程任务了。
|
||
|
||
## 常见问题
|
||
|
||
### 机器人没有响应怎么办?
|
||
|
||
1. 确保 WorkBuddy 正在运行,且 Claw 服务已开启
|
||
2. 检查 AppID 和 AppSecret 是否填写正确
|
||
3. 确认 Webhook 地址配置正确(需去掉 URL 开头的 `https://` )
|
||
4. 检查是否已添加单聊权限
|
||
|
||
### 收到「权限不足」提示怎么办?
|
||
|
||
返回 QQ 开放平台,在回调配置中确保已勾选所有必要的权限。
|
||
|
||
### 机器人审核需要多久?
|
||
|
||
通常为 1–3 个工作日,具体以 QQ 开放平台审核结果为准。审核期间可在应用列表中查看审核状态。 |