workbuddy怎么接入qq-腾讯WorkBuddy接入QQ教程

WorkBuddy接入QQ详细教程：全链路配置与实战指引

你是否希望让QQ具备驱动本地WorkBuddy执行自动化任务的能力？接入过程本质上是建立一套可靠的通信链路。本指南将详细拆解从准备、注册、配置到测试的每一个环节，助你高效完成集成。

WorkBuddy接入QQ的核心步骤解析

一、环境与账号准备

开始前，请确保满足以下两项必备条件：

首先，本地计算机需已安装并运行WorkBuddy客户端，并确保其Claw远程控制功能处于启用状态。其次，准备一个已完成实名认证的QQ账号。QQ开放平台对此有强制验证要求，未完成实名认证的账号将无法进行后续开发。

二、注册QQ开放平台开发者账号

集成始于平台入驻，这是获取调用权限的起点。

1. 访问并登录：进入QQ开放平台官方网站，使用你的QQ账号完成登录或注册流程。

2. 设置管理员：根据指引，设置此开发者账号的管理员。通常可选择本人担任。

3. 填写主体信息：依据你的实际情况，选择个人、企业或个体工商户等主体类型，并准确填写对应资料。个人开发者按表单指引操作即可。

4. 完成入驻：提交后，平台将进行审核，可能涉及人脸识别验证。审核通过即完成开发者入驻。

三、创建QQ机器人应用

接下来，在平台上创建作为消息接收端的机器人应用。

1. 登录平台：使用已入驻的QQ账号扫码登录开放平台后台。

2. 选择类型：在资源类型页面，明确选择「机器人」。

3. 填写应用信息：为机器人配置基础属性：

- 名称：设定机器人的显示名称，建议使用清晰易识别的文字，避免特殊字符。
- 头像：上传符合规范的图片作为机器人头像。
- 描述：简要说明其核心功能或用途。

4. 提交信息：确认无误后提交。注意，名称中如包含特殊符号可能导致创建失败。

5. 等待审核：提交后应用进入审核队列。请耐心等待平台审核通过。

四、获取关键应用凭证（AppID与AppSecret）

审核通过后，获取用于身份验证的核心密钥对。

1. 进入配置页：在应用列表中，点击已审核通过的机器人应用进入其管理后台。

2. 获取凭证：
- 在左侧导航栏进入「开发管理」页面。
- 记录页面显示的AppID，这是应用的唯一标识。
- 点击AppSecret旁的「生成」按钮获取密钥。

3. 安全提醒：AppSecret仅首次生成时明文显示，请立即妥善保存。一旦关闭页面或重新生成，旧密钥将即刻失效。

五、在WorkBuddy中配置QQ连接

将QQ机器人的身份凭证回填至WorkBuddy客户端。

1. 启动本地WorkBuddy软件，进入Claw功能设置界面。
2. 找到QQ集成或连接配置项。
3. 将上一步获取的AppID与AppSecret准确填入对应字段。
4. 保存配置。成功后，系统将生成一个唯一的Webhook回调地址，请复制此地址备用。

六、配置QQ机器人的Webhook回调

此步骤建立QQ平台向WorkBuddy推送消息的双向通道。

1. 复制地址：从WorkBuddy的设置中复制已生成的完整Webhook URL。

2. 返回QQ后台：进入QQ开放平台，从应用列表中选择你创建的机器人进行详细配置。

3. 设置回调地址：
- 导航至Webhook（或消息回调）配置页面。
- 在「请求地址」字段中粘贴复制的URL。
- 关键调整：粘贴后，需手动移除URL开头的“https://”协议头，仅保留域名及后续路径部分。
- 保存设置。

4. 开通消息权限：在回调配置页面，确保勾选所有与「私聊」或「单聊」相关的权限选项，以授权机器人接收并处理个人消息。

七、测试与使用

完成配置后，进行端到端的功能验证。

沙箱环境配置
1. 在机器人后台找到沙箱测试相关页面。
2. 进入「沙箱配置」，扫描“消息列表配置”区域提供的二维码，将测试QQ号加入白名单。

发起对话测试
打开QQ，找到已连接的WorkBuddy机器人会话窗口。尝试发送一条明确的指令，例如：“打开记事本”或“获取当前屏幕截图”，以测试指令下发是否成功。

监控执行反馈
指令发出后，WorkBuddy将在后台触发相应自动化流程。你可以在WorkBuddy客户端或任务日志中实时查看执行状态与最终输出结果。

至此，WorkBuddy与QQ的集成配置全部完成。整个过程涉及跨平台操作，关键在于准确复制凭证与正确配置回调地址。遵循此流程，你的智能QQ助手即可投入实战。