--- 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/#/) ,点击注册或登录。 ![QQ 开放平台注册](https://www.codebuddy.cn/docs/static/qq-guide-1.CiiIz-Zn.png) ### 1.2 设置超级管理员 按照页面提示,为平台设置超级管理员。您可以设置自己或其他人为管理员。 ![设置超级管理员](https://www.codebuddy.cn/docs/static/qq-guide-2.BqwT-LYk.png) ### 1.3 填写主体信息 根据您的实际情况,选择主体类型(企业、个体户或个人)并填写相关信息。以下以个人开发者为例: ![填写主体信息](https://www.codebuddy.cn/docs/static/qq-guide-3.C6ZGVrA0.png) ### 1.4 完成入驻 提交信息后,完成审核和人脸识别验证,即可成功入驻 QQ 开放平台。 ![审核通过](https://www.codebuddy.cn/docs/static/qq-guide-4.DNW77UNd.png) ## 2\. 创建 QQ 机器人 ### 2.1 登录开放平台 使用已注册的账号扫码登录 [QQ 开放平台](https://q.qq.com/#/) 。 ### 2.2 选择创建机器人 在资源类型选择页面,点击「机器人」选项。 ![选择机器人类型](https://www.codebuddy.cn/docs/static/qq-guide-6.nnNModB6.png) ### 2.3 填写机器人信息 填写机器人的基本信息: | 配置项 | 说明 | | --- | --- | | **名称** | 机器人的显示名称,建议不要包含特殊符号 | | **头像** | 上传一个机器人头像 | | **描述** | 简单描述机器人的功能 | ![创建机器人](https://www.codebuddy.cn/docs/static/qq-guide-7.Da42yQhe.png) ### 2.4 提交审核 确认信息无误后,点击提交。 注意 机器人名称中不要包含特殊符号,否则可能导致创建失败。 ![提交信息](https://www.codebuddy.cn/docs/static/qq-guide-8.CGUNXnpF.png) ### 2.5 等待审核通过 提交后,机器人会出现在您的应用列表中,等待审核通过即可使用。 ![机器人列表](https://www.codebuddy.cn/docs/static/qq-guide-9.BfmWI3_c.png) ## 3\. 获取应用凭证 ### 3.1 进入机器人配置页面 审核通过后,点击机器人图标进入配置页面。 ![进入机器人配置](https://www.codebuddy.cn/docs/static/qq-guide-10.CCJZB0Xd.png) ### 3.2 获取 AppID 和 AppSecret 1. 在左侧菜单中点击「开发管理」 2. 复制页面上显示的 **AppID** 3. 点击 AppSecret 旁边的「生成」按钮,获取密钥 ![获取 AppID 和 AppSecret](https://www.codebuddy.cn/docs/static/qq-guide-11.C3WC3uQR.png) 重要提示 - AppSecret 只会显示一次,请务必立即保存 - 如果忘记 AppSecret,需要重新生成,之前的密钥会失效 ![复制凭证](https://www.codebuddy.cn/docs/static/qq-guide-12.aEEm-IIH.png) ## 4\. 在 WorkBuddy 中配置 QQ 将获取的凭证配置到 WorkBuddy 中: 1. 打开 WorkBuddy,进入 **Claw 设置** 2. 选择 **QQ 集成** 3. 填入刚才获取的 AppID 和 AppSecret 4. 点击保存 保存成功后,系统会生成 Webhook 地址,用于下一步配置。 ![WorkBuddy 配置 QQ](https://www.codebuddy.cn/docs/static/qq-guide-13.D00-85p8.png) ## 5\. 获取并配置 Webhook ### 5.1 复制 Webhook 地址 在 WorkBuddy 的 Claw 设置中,找到系统生成的 Webhook 地址,点击复制。 ![WorkBuddy Claw 设置中的 Webhook 配置区域](https://www.codebuddy.cn/docs/static/qq-guide-14.Y4tih5y8.png) ### 5.2 配置 QQ 机器人回调地址 1. 返回 [QQ 机器人后台](https://q.qq.com/#/apps?tab=1) 2. 选择需要配置的机器人 提示 如果您创建了多个机器人,请确保选择正确的机器人进行配置。 ![选择机器人](https://www.codebuddy.cn/docs/static/qq-guide-15.DSrlkHfl.png) 1. 访问 [Webhook 设置页面](https://q.qq.com/qqbot/#/developer/webhook-setting) 2. 在「请求地址」输入框中粘贴 Webhook 地址 ![配置 Webhook](https://www.codebuddy.cn/docs/static/qq-guide-16.zl5z4ZWm.png) 注意 粘贴时需要 **去掉 URL 开头的 `https://`** ,只保留域名和路径部分。 ![去掉 https 前缀](https://www.codebuddy.cn/docs/static/qq-guide-17.CO8A9eL8.png) 1. 点击确认保存配置 ### 5.3 添加消息权限 在回调配置页面,勾选所有「单聊」相关的权限,确保机器人能够接收和发送消息。 ![添加权限](https://www.codebuddy.cn/docs/static/qq-guide-19.EBCLFFWZ.png) ## 6\. 开始使用 配置完成后,您可以通过以下方式开始使用: ### 6.1 进入沙箱测试 1. 访问 [沙箱配置页面](https://q.qq.com/qqbot/openclaw/index.html) 2. 点击「沙箱配置」,然后扫描消息列表配置处的二维码 ![沙箱配置](https://www.codebuddy.cn/docs/static/qq-guide-20.BDepSuBE.png) ### 6.2 与机器人对话 在 QQ 中打开与 WorkBuddy 机器人的对话窗口,直接发送您的需求,例如「帮我写一个网页」。 ![发送需求](https://www.codebuddy.cn/docs/static/qq-guide-22.3dd_MZWi.png) ### 6.3 查看执行结果 WorkBuddy 会在电脑上自动执行任务,您可以实时查看执行进度和结果。 恭喜 您已成功将 WorkBuddy 接入 QQ!现在可以通过 QQ 随时随地远程控制 WorkBuddy 完成各种编程任务了。 ## 常见问题 ### 机器人没有响应怎么办? 1. 确保 WorkBuddy 正在运行,且 Claw 服务已开启 2. 检查 AppID 和 AppSecret 是否填写正确 3. 确认 Webhook 地址配置正确(需去掉 URL 开头的 `https://` ) 4. 检查是否已添加单聊权限 ### 收到「权限不足」提示怎么办? 返回 QQ 开放平台,在回调配置中确保已勾选所有必要的权限。 ### 机器人审核需要多久? 通常为 1–3 个工作日,具体以 QQ 开放平台审核结果为准。审核期间可在应用列表中查看审核状态。