腾讯云代理商：腾讯云部署的Hermes Agent如何接入QQ ？

当你的 Hermes Agent 在腾讯云 Lighthouse 上稳稳跑起来后，若还局限在终端操作，就太浪费它的能力了。

今天给大家一套零代码、低门槛 的接入方案，让 QQ 直接成为你的 AI 入口，不管是单聊问问题、群聊协同处理，还是随手指令，都能秒回响应，真正实现 "随时随地，随叫随到"。

一、接入前必看：3 个前提，一次核对

这一步不踩坑，后续全程顺畅。

1. ✅ 腾讯云 Lighthouse 已成功部署 Hermes Agent，服务器正常运行，且模型配置完成 （可通过hermes命令测试对话）；
2. ✅ 拥有已实名认证的 QQ 账号 （用于登录 QQ 开放平台创建机器人，个人 / 企业主体均可）；
3. ✅ 服务器80/443 端口已放行 （QQ 机器人回调通信必需，腾讯云控制台→轻量服务器→防火墙，手动添加规则）。

二、第一步：QQ 开放平台创建机器人，拿核心凭证

这是机器人的 "身份证"，关乎后续连接，务必妥善保存。

1. 登录 QQ 开放平台，用已实名认证的 QQ 账号 扫码登录；
2. 进入控制台，点击创建应用 →选择机器人 类型，填写名称、头像和描述（建议清晰标注功能，方便识别）；
3. 创建成功后，进入凭证与基础信息 页，复制AppID 和AppSecret （这两个是核心凭证，AppSecret 生成后仅显示一次，忘记需重置）；
4. 关键配置：在消息订阅 设置中，填写回调地址（格式：https://你的服务器域名/callback/qq），用于 QQ 与服务器通信。

三、第二步：Hermes Agent 配置，一键绑定 QQ

两种配置方式，按需选择，新手推荐可视化向导，零代码门槛。

方法 1：可视化向导

1. 登录腾讯云 Lighthouse 控制台，进入 Hermes Agent 实例的应用管理 页，打开可视化面板；
2. 找到Messaging Platforms（消息平台） →添加通道 ，选择QQ Bot ；
3. 依次填入AppID 和AppSecret ，点击测试连接 ，显示 "连接成功" 即配置完成；
4. 点击保存并启用 ，Hermes Agent 的 QQ 通道就正式上线了。

方法 2：命令行配置

1. 通过 SSH 登录腾讯云服务器，执行一些命令启动配置
   按终端提示，依次输入AppID 和AppSecret （输入 Secret 时屏幕无显示，直接粘贴即可）；
2. 系统自动校验并保存配置，提示 "配置成功" 后，重启网关服务生效。

四、第三步：QQ 端测试，体验 AI 秒响应

配置完成后，无需额外操作，直接在 QQ 中找到机器人，开始对话即可。

1. 打开 QQ，搜索你创建的机器人名称，添加为好友 ；
2. 发送测试指令（如 "帮我写一段工作周报""总结这篇文档的核心要点"），秒收智能回复；
3. 进阶玩法：
   1. 群聊场景：将机器人拉入群聊，@机器人 即可触发对话，支持多人协同互动；
   2. 语音交互：发送语音指令，机器人自动识别并语音回复（需确保 Hermes Agent 已配置 STT/TTS 技能）；
   3. 文件处理：上传图片、文档，机器人可直接解析总结，高效处理信息。