QQ 官方机器人接入：WebSockets 稳定路线
官方文档在 QQ 接入场景下给出了明确倾向：「如果打算接入 QQ，推荐使用 QQ 官方机器人（WebSockets）」。这一页说清它是什么、怎么接、什么情况下反而该选另一条路。
它是什么
QQ 官方机器人是腾讯官方推出的机器人体系，框架以 WebSockets 方式直连官方接口：
- 稳定性由官方背书，不受第三方协议端项目维护节奏影响
- 支持一键扫码登录，不需要单独部署 NapCat 之类的实现端
- 消息链路全程走腾讯官方通道
接入步骤概要
- 到 QQ 开放平台注册开发者账号并创建机器人，拿到 AppID、Token 等凭证
- 框架 WebUI「机器人」→「创建机器人」，选 QQ 官方机器人（WebSockets）类型
- 填入开放平台发的凭证，保存并启用
- 日志页确认适配器连接成功
具体的开放平台操作与沙箱测试流程，以 QQ 开放平台当前文档为准；框架侧的表单项如有增减，以框架官方文档 platform/qqofficial 分组下的最新页面为准。
两条路线怎么取舍
| 维度 | 官方机器人 | NapCat + OneBot v11 |
|---|---|---|
| 稳定性 | 官方通道，最稳 | 取决于实现端项目 |
| 部署成本 | 零额外组件 | 多跑一个 NapCat |
| 能力边界 | 受平台机器人规范限制 | 能力上限更高 |
| 账号风险 | 无风控顾虑 | 协议端存在风控可能 |
| 登录方式 | 扫码一键 | QQ 号扫码，等同登录 PC QQ |
一句话决策：怕封号、要省心 → 官方机器人；要完整功能、能接受折腾 → OneBot 路线。很多用户的实际做法是两条都接，官方号对外服务，OneBot 号自用。
官方路线的局限要有预期
官方机器人接口在消息类型、主动消息频次、群管理能力上有平台规则约束，部分第三方生态插件依赖的能力它给不了。插件装上后部分功能在官方通道下不生效，多半不是插件坏了，而是平台没开放对应接口。Webhook 方式的接入变体（无需长连接）同样有官方文档支持，服务器只出不进的网络环境可以看那条路线。