Hermes Agent 接入 QQ：从 0 到 1 打造 AI QQ 机器人（超详细实战指南）-171主机测评

一、背景：为什么要把“爱马仕（Hermes Agent）”接入 QQ？

如果你已经接触过 Hermes Agent，你应该知道它不是普通聊天机器人，而是一个具备长期记忆 + 工具调用 + 自我进化能力的 AI Agent。

官方定义很明确：

Hermes 是一个“会成长”的 AI，会不断积累经验并优化自身能力

但问题来了：

👉 单纯跑在 CLI 里，没有“入口”，价值有限 👉 真正的使用场景，一定在通讯平台

而 QQ 的优势是：

国内用户基数大
群聊生态成熟
自动化空间巨大（客服 / 社群 / 工具助手）

所以这篇文章核心就是：

✅ 把 Hermes 变成一个真正能用的 QQ AI 助手

二、整体架构：Hermes + QQ Bot 是怎么工作的？

先讲清楚架构，不然你只是“照着做”，不知道为什么。

1. 核心组件

Hermes QQ Bot 其实是三层结构：

QQ用户 → QQ官方Bot → Hermes Gateway → Hermes Agent → LLM

详细拆解：

QQ 官方 Bot API

负责接收消息（WebSocket）
发送消息（HTTP REST）

Hermes Messaging Gateway

Hermes 的“中间层”
把 QQ 消息转成 Agent 可理解的输入

Hermes Agent

处理逻辑、调用工具、记忆上下文

LLM（模型）

GPT / Claude / GLM / 本地模型等

2. 数据流

整个链路是这样的：

用户发消息 → QQ Gateway → Hermes Gateway（解析） → Hermes Agent（思考 + 工具调用） → 返回结果 → QQ Bot API → 用户看到回复

3. Hermes 的关键优势

和普通 QQ Bot 最大区别：

能力普通机器人Hermes

上下文记忆	❌	✅
工具调用	❌	✅
多平台	❌	✅
自学习	❌	✅

三、官方能力解析（重点）

根据文档，QQ Bot Adapter 提供以下能力：

1. 消息能力

支持：

私聊（C2C）
群 @ 消息
频道消息（Guild）
Direct Message

👉 也就是说：可以做企业级客服 / 社群助手

2. 多媒体能力

Hermes 能处理：

图片
语音（自动转文字）
文件

语音识别流程：

QQ 自带 ASR（优先）

fallback 到外部 STT（如 Whisper）

3. 通信机制

WebSocket（收消息）
HTTP（发消息）

👉 这点很关键：说明是实时通信，不是轮询

四、接入前准备

1. 注册 QQ Bot

去官方：

👉 https://q.qq.com

你需要：

App ID
App Secret
开启权限（intents）

必须开启：

私聊消息
群 @ 消息
Guild 消息

2. 安装 Hermes

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

3. 安装依赖

pip install aiohttp httpx

（这是 QQ adapter 必需的）

五、核心接入步骤（重点）

Step 1：启动 Gateway 配置

hermes gateway setup

选择：

QQ Bot

Step 2：填写配置

你会输入：

QQ_APP_ID=xxx QQ_CLIENT_SECRET=xxx

或者手动写入：

~/.hermes/.env

Step 3：启动服务

hermes gateway start

Step 4：测试

在 QQ 里：

👉 私聊机器人 👉 群里 @机器人

如果正常，会直接回复

六、高级配置（真正拉开差距的地方）

基础接入只是开始，真正牛逼的是“调教 Hermes”。

1. config.yaml 配置

路径：

~/.hermes/config.yaml

示例：

platforms: qq: enabled: true extra: markdown_support: true dm_policy: "open" group_policy: "open"

2. 权限控制

allow_from: – "user_openid"

👉 做白名单系统

3. 群控制

group_allow_from: – "group_id"

👉 只允许指定群使用

4. 语音识别增强

默认：

腾讯 ASR

高级玩法：

QQ_STT_API_KEY=xxx QQ_STT_MODEL=whisper-1

👉 接入 OpenAI Whisper

七、实战案例：做一个“QQ AI 助手”

这里给你一个真实可用场景👇

场景：社群运营助手

功能：

自动回复问题
总结聊天内容
定时推送

实现方式

1. 使用 Hermes cron

hermes cron add "每天10点总结群聊"

2. 使用技能（skills）

Hermes 会自动创建技能：

FAQ回答
数据分析
自动回复

3. 群聊触发

用户：

@机器人总结今天内容

Hermes：

👉 自动分析历史上下文 👉 输出总结

八、进阶玩法（核心价值）

1. 多平台统一

Hermes 支持：

Telegram
Discord
QQ
微信（可扩展）

👉 一个 Agent，多入口

2. Agent 自动工作

你可以让它：

自动写日报
自动爬数据
自动分析

3. 子 Agent

Hermes 支持：

多 Agent 并行
任务分解

👉 这才是“真正 AI 助手”

九、常见问题（踩坑总结）

1. 机器人连不上

原因：

App ID 错
Secret 错

2. 收不到消息

检查：

intents 是否开启
群是否 @ 机器人

3. 语音不识别

检查：

是否有 asr_refer_text
STT API 是否配置

4. 只能沙盒用

👉 没发布应用

十、架构升级建议（非常重要）

如果你想做“商业级”，建议：

1. 部署在服务器

2. 使用 OpenRouter

优点：

多模型切换
成本低

3. 加一层 API

结构升级：

QQ → Hermes → 你自己的API → LLM

👉 控制成本 + 做缓存

十一、总结

一句话总结：

Hermes + QQ Bot = 一个真正能干活的 AI 员工

核心价值：

不是聊天机器人
是自动化执行系统

十二、未来扩展

你可以继续做：

接入微信（企业级）
接入飞书
做 SaaS 平台
做 AI 中台

最后一句（重点）

如果你只是接入 QQ：

👉 那只是“机器人”

如果你用好 Hermes：

👉 那是“数字员工”