3.6 QQ Bot 接入

平台 第三章：多平台接入

QQ Bot 接入概述

通过 QQ 开放平台创建官方机器人账号，适合社群运营和粉丝互动场景。相比个人号更安全、更稳定。

配置步骤

第一步：创建机器人

访问 QQ 开放平台（q.qq.com），在开发者中心创建机器人应用。

第二步：获取凭证

从机器人管理页面获取以下信息，配置到 ~/.hermes/.env：

QQ_BOT_APP_ID=your_app_id
QQ_BOT_TOKEN=your_bot_token
QQ_BOT_SECRET=your_secret

第三步：启动网关

使用网关设置命令，选择 QQ 平台：

hermes gateway setup
# 选择 QQ Bot

第四步：验证接入

启动网关和 CLI，在群聊中 @机器人 测试：

hermes gateway start
hermes  # 在新终端启动 CLI

适用场景

  • 社群运营：群公告、群签到、自动回复
  • 粉丝互动：粉丝答疑、内容推荐、投票问卷
  • 内容分发：定时发送资讯、学习内容、活动通知
  • 智能客服：自动应答常见问题

常见问题

机器人无法回复消息？

检查以下几点：

  • 机器人是否已被拉入群聊，是否有权限发言
  • API Token 和 Secret 是否正确配置
  • 网关服务是否正常运行（hermes gateway status）

如何指定特定群聊？

在 ~/.hermes/config.yaml 中配置 QQ 网关的群组过滤规则。