QQ 机器人配置完全指南：Hermes Agent 接入 QQ 官方机器人教程
Hermes Agent Helperon a month ago
概述
QQ 机器人是腾讯官方提供的机器人平台，Hermes Agent 支持通过 QQ 官方机器人与用户进行对话交互。相比微信，QQ 机器人使用官方 API，安全稳定，无封号风险。
预计配置时间：5-10 分钟
所需信息：
- QQ 机器人密钥（Bot Secret）
QQ 机器人的优势
对比微信
| 特性 | QQ 机器人 | 微信 |
|---|---|---|
| 富文本消息 | ✅ 支持 | ❌ 不支持 |
| 封号风险 | ✅ 无（官方 API） | ⚠️ 有风险 |
| 在线状态 | ✅ 清晰可见 | ❌ 不明显 |
| 配置复杂度 | 中低 | 低 |
对比飞书
| 特性 | QQ 机器人 | 飞书 |
|---|---|---|
| 消息翻译 | ❌ 不支持 | ✅ 支持 |
| 表情回复 | ❌ 不支持 | ✅ 支持 |
| 交互式卡片 | ❌ 不支持 | ✅ 支持 |
| 群聊机器人 | ❌ 不支持 | ✅ 支持 |
第一步：创建 QQ 机器人
1.1 进入 QQ 机器人开放平台
- 打开 QQ 机器人开放平台
- 使用你的 QQ 账号登录
- 按照页面提示完成开发者认证（如需要）
1.2 创建机器人
- 在控制台中，点击「创建机器人」
- 填写机器人信息：
- 机器人名称：填写一个易于识别的名称，如「Hermes AI 助手」
- 机器人描述：简要描述机器人用途
- 机器人头像：上传一个头像（可选）
- 完成创建
1.3 获取机器人密钥
创建完成后，进入机器人详情页：
- 找到「密钥」或「Bot Secret」区域
- 复制机器人密钥
请妥善保存此密钥，后续配置需要使用。
第二步：配置 Hermes Gateway
2.1 打开 Hermes 服务管理工具
登录你的 Hermes 服务管理工具 Web 界面。
2.2 配置 QQ 机器人
- 切换到「环境变量」或「Config」标签页
- 找到 QQ 机器人相关配置项
- 填入你的机器人密钥
- 保存配置
配置将自动重启网关服务。
第三步：验证配对
3.1 首次聊天触发验证
当你第一次向 QQ 机器人发送消息时，Hermes 会触发安全验证流程。
3.2 执行配对命令
机器人会回复一条包含配对命令的消息，格式类似：
hermes pairing approve qqbot xxxxx
你需要在 Hermes 服务器上执行这个命令来完成配对：
- 登录 Hermes 服务管理工具
- 切换到「终端」标签页
- 输入机器人回复的完整命令并执行
3.3 验证成功
命令执行成功后，你就可以正常与 QQ 机器人聊天了！
常见问题
Q: 为什么需要执行配对命令？
A: 这是 Hermes Agent 的安全机制，用于验证消息来源的合法性。只有经过配对的用户才能与机器人进行对话，防止未授权访问。
Q: 配对命令执行失败怎么办？
A: 请检查：
- 命令是否完整复制（包括所有参数）
- 是否在正确的终端执行（Hermes 服务器）
- Hermes 服务是否正常运行
Q: 可以在群聊中使用 QQ 机器人吗？
A: 目前 QQ 机器人暂不支持群聊功能，只能在私聊中使用。如需群聊功能，建议使用飞书平台。
Q: 消息发送后没有回复怎么办？
A: 请检查：
- 是否已完成配对验证
- Hermes Gateway 是否正常运行
- LLM API 配置是否正确
下一步
配置完成后，你可以：
- 开始对话：在 QQ 中找到你的机器人，发送消息开始聊天
- 安装技能：使用
hermes skill install安装各种实用技能 - 切换模型：根据需要切换不同的 AI 模型
如有任何问题，请联系我们的技术支持。