QQ 机器人
QQ Bot Channel 通过官方 WebSocket Gateway 接收事件，并调用平台 API 发送回复。协议会话由常驻 Gateway 维护。
准备材料
- QQ Bot 应用；
- App ID；
- App Secret，在 Anyy 中作为
client_secret输入； - 可选的 Bot User ID；
- C2C 与群聊
@消息所需的 Gateway Intent。
事件配置请查看 QQ Bot 官方事件订阅文档。
在 Dashboard 中连接
- 打开 Dashboard → Channel → Add account。
- 选择 QQ Bot 和 WebSocket Gateway。
- 填入 App ID、App Secret。
- 只有确实需要匹配平台身份时才填写 Bot User ID。
- 检查私信和群聊策略并保存。
- 在 QQ Bot 控制台启用 C2C/群聊 @ 消息 Intent。
默认账号 ID 是 bot，该 Profile 不需要公网入站 Webhook。
访问策略
私信默认 pairing，群聊默认 mention：
- 私信：
pairing、open、allowlist、disabled； - 群聊：
mention、open、allowlist、disabled。
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
验证连接
anyy channel doctor qqbot
anyy channel reload
分别测试一条 C2C 消息和一条群聊 @ 消息，因为两者依赖不同的事件和策略路径。
身份检查正常但收不到消息时，先查 Intent
如果 Doctor 能识别 Bot 身份，说明凭据大概率有效。此时优先检查 Gateway Intent 和事件订阅，不要立即轮换 App Secret。
故障排查
| 现象 | 检查项 |
|---|---|
| Gateway 认证失败 | App ID 和 App Secret |
| 已连接但没有事件 | C2C/群聊 @ Intent 和应用可用状态 |
| 私信被忽略 | 私信策略和配对/allowlist |
| 群消息被忽略 | 群聊策略和是否明确 @ Bot |
| 能收不能发 | Bot 身份和平台发信授权 |