Hermes Agent 接 QQ Bot,核心是先在 q.qq.com 创建应用,然后把 QQ_APP_ID 和 QQ_CLIENT_SECRET 配给网关。官方文档还特别提醒:QQ 这里很多权限和 allowlist 用的是 OpenID,不是你平时看到的 QQ 号或昵称。
怎么配
- 先在 QQ Bot 开发平台建应用,拿到 App ID 和 Secret。
- 确认需要的 intents 已经开了,比如 C2C、群 @ 消息、Guild 消息。
- 在
.env写入QQ_APP_ID、QQ_CLIENT_SECRET。 - 需要 cron 或主动通知时再补
QQBOT_HOME_CHANNEL。 - DM 和群聊权限分开配,别把全局开放和群开放混成一件事。
如果你做中文团队场景,这个集成很有价值,但前提是先把 OpenID、sandbox 路由和权限模型搞清楚。
一句话:QQ Bot 的最大坑不是连不上,而是把 QQ 号、昵称和 OpenID 当成同一种东西。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。