## 概述

云上 Hermes Agent 如何接入 QQ？整个流程约 5–10 分钟：先在 QQ 开放平台创建一个 QQ 机器人，拿到 **AppID** 与 **AppSecret**，再填入腾讯云 Lighthouse 的 Hermes Agent 配置面板，即可完成接入。

如果你还不了解 Hermes Agent，或尚未在 Lighthouse 中部署 Hermes Agent，建议先参考 [《玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent》](https://cloud.tencent.com/developer/article/2653159) 完成部署。本文聚焦"部署完成后如何把 QQ 接进来"。

---

## 前置准备

在开始之前，请依次确认以下事项：

- 你拥有一个已完成实名认证的 QQ 账号（作为机器人管理员）
    
- 你已在腾讯云 Lighthouse 中部署 Hermes Agent。如果尚未部署，参考 [《使用 Lighthouse 快速部署云上 Hermes Agent》](https://cloud.tencent.com/developer/article/2653159)
    
- 你已在 Hermes Agent 配置面板中完成**模型（Models）**配置。若尚未配置，参考总教程的 [「步骤二：配置模型」](https://cloud.tencent.com/developer/article/2653159)
    

> 云上 Hermes Agent 接入 QQ 场景推荐使用国内地域的 Lighthouse 实例与国内模型服务。

---

## 第一部分：在 QQ 开放平台创建机器人

### 1. 注册 / 登录 QQ 开放平台

前往 [腾讯 QQ 开放平台](https://q.qq.com/qqbot/openclaw/)，使用手机 QQ 扫描页面上的二维码进行注册或登录。

![Clipboard_Screenshot_1777118113.png](https://developer.qcloudimg.com/http-save/yehe-11556714/4b3eb28982c02eae0b1ac739e9cca84e.png)
> ℹ️ **首次注册**
>
> 如果你尚未注册 QQ 开放平台，扫码后系统会自动完成注册流程，并将扫码所用的 QQ 账号与开放平台账号进行绑定。

在手机 QQ 扫码后单击**同意**，即完成注册/登录，进入 QQ 机器人配置页。

### 2. 创建一个 QQ 机器人

在 QQ 开放平台的**我的机器人**页面，单击「创建机器人」，按页面引导填写机器人名称、简介、头像等基础信息，新建一个 QQ 机器人。
![Clipboard_Screenshot_1777118068.png](https://developer.qcloudimg.com/http-save/yehe-11556714/31d113c34555a0b42e03a9b93e0459d0.png)

> 💡 如果你看到机器人管理页面中展示的 "OpenClaw 原生接入流程"（三条命令行），请忽略——那是 OpenClaw 命令行接入方式，Hermes Agent 使用的是 Lighthouse 可视化面板，**不需要执行任何命令**。

### 3. 获取 AppID 与 AppSecret

机器人创建完成后，在机器人的**开发设置**页找到 **AppID** 和 **AppSecret** 两个参数，分别单击右侧「复制」按钮，保存到本地记事本或备忘录中，后续步骤中需要使用。
![Clipboard_Screenshot_1777118242.png](https://developer.qcloudimg.com/http-save/yehe-11556714/bb71b629d0eddceef640f3f814e88259.png)

> ⚠️ **AppSecret 属于敏感凭证**
>
> - 出于安全考虑，**AppSecret 不支持明文二次查看，再次查看将强制重置**。请务必在创建时立即保存
>
> - 请勿发送至聊天群、公开网页或提交至 Git 仓库
>
> - 若 AppSecret 泄露，应立即在 QQ 开放平台「重置密钥」，并在 Hermes Agent 配置面板重新填入新密钥
>

### 4. 机器人已加入 QQ 消息列表（尚不可对话）

回到 QQ 软件，新建的 QQ 机器人已经被自动添加至消息列表中，并会发送第一条欢迎消息。

此时尚未完成与 Hermes Agent 的绑定，机器人**无法正常对话**——发送消息会收到提示：

> 该机器人去火星了，稍后再试吧

这是正常现象，继续执行下面的步骤为 Hermes Agent 配置 AppID 与 AppSecret 即可。

---

## 第二部分：在 Hermes Agent 配置面板填入参数

### 5. 进入 Hermes Agent 配置面板

登录 [腾讯云 Lighthouse 控制台](https://console.cloud.tencent.com/lighthouse)，找到已部署 Hermes Agent 的实例，单击实例卡片任意空白处进入实例详情页，在顶部导航中切换到**应用管理**页。

此时你会看到 Hermes Agent 配置面板，从左到右依次是：模型（Models）、通道（Channels）、技能（Skills）三个卡片。

> ⚠️ 如果应用管理页展示的只是"应用内软件信息"（Hermes Agent 版本号、官方文档链接），说明当前应用模板版本较旧，未集成可视化配置面板。需要通过"重装系统"选择最新的 Hermes Agent 应用模板升级，具体参考总教程的 [「方式二：重装一台现有的 Lighthouse」](https://cloud.tencent.com/developer/article/2653159)。重装会清空服务器内数据，如有重要内容请先备份。

### 6. 选择 QQ 通道并填入 AppID / AppSecret

在**通道（Channels）**卡片的下拉框中选择「QQ」，卡片中出现两个输入框：

1. **AppID**：粘贴第 3 步中复制的 AppID
    
2. **AppSecret**：粘贴第 3 步中复制的 AppSecret
    
请确认首尾无空格或换行。
![Clipboard_Screenshot_1777118257.png](https://developer.qcloudimg.com/http-save/yehe-11556714/7ce93b073025892374de018fb5df3624.png)

### 7. 单击「添加并应用」

Hermes Agent 会使用上述凭证连接 QQ 开放平台上的机器人，等待几十秒后页面提示**保存成功**，「已接入通道」列表中出现"QQ"记录。

> 💡 **多通道并存**
>
> Hermes Agent 支持同一台 Lighthouse 实例同时接入多个通道（例如 QQ + 微信 + 飞书）。在「通道」卡片依次切换下拉选项并完成各自的接入流程即可。

---

## 第三部分：在 QQ 中与 Hermes Agent 对话

配置完成后，在 QQ 软件中找到前面创建的机器人，直接发起对话。发送测试消息：

```
你好，请做一下自我介绍
```

如果机器人能够以 AI 方式回复，说明 Hermes Agent 已成功接入 QQ 机器人。
![Clipboard_Screenshot_1777118285.png](https://developer.qcloudimg.com/http-save/yehe-11556714/e60d53396eae1031fad36d5364eb8010.png)

> ⚠️ **暂不建议加入 QQ 群聊**
>
> 当前版本不建议将 QQ 机器人加入 QQ 群进行多人对话。

---

## 支持的消息类型

接入成功后，QQ 机器人支持的消息类型如下：

| 消息类型 | 是否支持 |
| --- | --- |
| 接收文本信息 | ✅ 已支持 |
| 接收图片 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 接收语音消息 | ✅ 已支持 |
| 回复文本信息 | ✅ 已支持 |
| 回复图片 | ✅ 已支持 |
| 回复文件 | ✅ 已支持 |
| 回复内容支持 Markdown 格式 | ✅ 已支持 |
| 主动发送消息（如定时提醒） | ✅ 已支持 |
| 历史消息引用 | ❌ 不支持 |

> ℹ️ **实际处理能力取决于模型**
>
> 上表仅代表 QQ 机器人在消息通道层面支持的类型。能否实际处理图片、文件等任务，还取决于 Hermes Agent 所接入的大语言模型是否具备对应的处理能力。例如要让 Hermes Agent 分析图片，需要配置支持图片理解的多模态模型；要让 Hermes Agent 生成图片，需要配置支持图片生成的模型。

---

## 成功状态

- QQ 开放平台上 QQ 机器人已创建
    
- Hermes Agent 配置面板的「已接入通道」列表中出现"QQ"
    
- QQ 中的机器人能以 AI 方式正常回复消息
    

---

## 常见问题

### 机器人回复"我的'灵魂'不在线，请检查你的主机服务部署环境"

**原因**：未在 Hermes Agent 配置面板填写 AppID 和 AppSecret，或填写的凭证错误。

**处理**：重新在 QQ 开放平台复制 AppID 和 AppSecret，确认首尾无空格后在配置面板重新填入。

### 机器人回复"该机器人去火星了，稍后再试吧"

**原因**：QQ 机器人已在 QQ 开放平台创建，但尚未与 Hermes Agent 绑定。

**处理**：按本页「第二部分」流程完成 AppID / AppSecret 的配置。

### 完成所有配置后机器人仍不回复

**可能原因**：模型未配置成功，导致机器人无法生成回复。

**排查方式**：

1. 进入 Hermes Agent 配置面板的「模型」卡片
    
2. 检查「当前模型」区域是否有记录
    
3. 确认 API Key 填写正确、对应模型服务商账户余额充足
    
4. 如需进一步验证模型是否生效，可登录 Lighthouse 服务器使用 Hermes Agent 命令行工具进行测试（参考总教程「常见问题」章节）
    

### 找不到 AppSecret 怎么办

AppSecret 仅在创建时完整显示一次。若关闭页面后再次进入发现无法查看，只能在 QQ 开放平台单击**「重置密钥」**生成新值，然后在 Hermes Agent 配置面板重新填入。

### AppSecret 泄露了怎么办

立即前往 QQ 开放平台「重置密钥」，并在 Hermes Agent 配置面板重新填入新的 AppSecret。旧密钥失效后，泄露的凭证无法再被他人使用。

### 对话报错 HTTP 401 / InvalidAuthentication

通常与 QQ 通道无关，而是**模型 API Key** 的问题。常见原因：

1. 模型 API Key 配置错误
    
2. 混淆了 Coding Plan（包月套餐）与普通模型 API 的 Key
    
3. 错误选择了模型服务商提供的国内版 / 国际版
    

遇到该提示时建议先回到「模型」卡片重新检查配置。

---

## 更多教程

更多云上 Hermes Agent 实践教程，如一键部署 Hermes Agent、配置模型、接入微信/飞书、安装并使用技能（Skills）等，欢迎查看 [Hermes Agent 部署总教程](https://cloud.tencent.com/developer/article/2653159)。

云上 Hermes Agent 如何接入 QQ？整个流程约 5–10 分钟：先在 QQ 开放平台创建一个 QQ 机器人，拿到 AppID 与 AppSecret，再填入腾讯云 Lighthouse 的 Hermes Agent 配置面板，即可完成接入。

玩转 Hermes Agent｜云上 Hermes Agent 快速接入 QQ 指南

云计算

后端

开发工具

5分钟快速接入QQ机器人：在QQ开放平台创建机器人获取AppID/AppSecret，填入腾讯云Lighthouse的HermesAgent配置面板即可完成对接。支持文本、图片、文件等多种消息交互，实现智能对话功能。

4核4G3M云服务器 新用户低至38元/年！

lighthouse

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

玩转 Hermes Agent｜云上 Hermes Agent 快速接入 QQ 指南-腾讯云开发者社区-腾讯云

玩转 Hermes Agent｜云上 Hermes Agent 快速接入 QQ 指南

玩转 Hermes Agent｜云上 Hermes Agent 快速接入 QQ 指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐