Hermes Agent快速接入 QQ 完整教程｜QQ聊天使用AI智能体
Hermes Agent它是一个能够自我成长的Agent，一方面能够更持久地记忆和更准确地回忆，另一方面它也拥有完整的自我学习能力：能够自主创建技能，并在使用中不断改进技能，在"越用越聪明"的方向提出了一种可行的方法。
Hermes Agent作为可自进化、长记忆、跨平台的AI智能体，现已支持一键接入QQ，无论是私聊、群聊@机器人，都能直接调用AI能力：写代码、读文件、做总结、执行自动化任务。
下面将详细介绍如何在Hermes Agent中接入QQ，实现QQ与AI的对话操作。
一、前置条件
在开始配置之前，请确保完成以下准备工作：
二、第一步：QQ开放平台创建机器人
打开QQ开放平台：https://q.qq.com/qqbot/openclaw/login.html?redirect_url=https%3A%2F%2Fq.qq.com%2Fqqbot%2Fopenclaw%2F
使用手机QQ扫码或密码登录**
点击 创建机器人，自动生成机器人账号
记录2个关键信息（务必保存）：
- AppID
- AppSecret（机器人密钥，只显示一次）
机器人已加入 QQ 消息列表（尚不可对话）
重要：AppSecret不支持二次查看，忘记只能重置。
回到 QQ 软件，新建的 QQ 机器人已经被自动添加至消息列表中，并会发送第一条欢迎消息。
此时尚未完成与 Hermes Agent 的绑定，机器人无法正常对话——发送消息会收到提示：
该机器人的’灵魂’不在线，请检查它的主机服务部署环境。
这是正常现象，继续执行下面的步骤为 Hermes Agent 配置 AppID 与 AppSecret 即可。
三、第二步：Hermes 配置 QQ 网关
进入你的 Hermes 终端，执行配置命令
hermes gateway setup
方向键选择 QQ Bot，回车确认
输入刚才获取的：
- Bot ID / AppID
- AppSecret
配置访问策略（直接回车默认即可）：
- 使用DM配对审批（推荐）
- 允许所有私信
- 仅允许列出的用户OpenIDs
主频道OpenID（用于定时任务/通知，或留空）：（直接回车默认即可）
重启网关以应用更改？[Y/n]：y
四、第三步：启动网关并测试
1. 启动网关
查看网关启动状态
hermes gateway status
前面如果没有启动网关时，执行下面命令执行hermes 网关
hermes gateway
看到 Gateway started 即为启动成功。
2. 使用QQ对话
-
私聊：直接给机器人发消息即可
-
群聊：@机器人 提问
Hermes 会自动调用能力、记忆上下文，越用越智能。
3. 配对授权
第一次对话时会提示需要执行命令配对授权
hermes pairing approve qqbot KZ****
五、常用运维命令
1. 查看网关状态
hermes gateway status
2. 重启网关
hermes gateway restart
3. 允许用户访问机器人
hermes pairing approve qqbot 配对码
六、常见问题（避坑必看）
机器人不回复消息
- 检查网关是否启动：hermes gateway status
- 确认 AppID、AppSecret 正确无误
- 检查是否已授权用户访问
提示依赖缺失
执行安装依赖：
pip install aiohttp httpx
群聊@无响应
- 确认机器人已加入群组
启动报错端口占用
重启网关即可：
hermes gateway restart
七、总结
Hermes Agent 接入QQ仅4步：
QQ开放平台创建机器人 → 获取ID+密钥
执行 hermes gateway setup 配置QQ
启动网关，QQ直接对话
授权配对
无需服务器公网IP、无需域名备案、无需复杂回调配置，几分钟即可拥有私人QQ AI助理，支持多轮记忆、任务执行、自动化办公。
欢迎大家使用和持续关注。
