消息平台接入总览：两条路线与十八个平台
模型是脑子，消息平台是嘴巴和耳朵。这一组页面对象是「让消息进来」这个环节。接平台前先看清两条技术路线，很多困惑源于把两条路混着理解。
路线一：平台官方机器人 API
直接对接平台官方提供的机器人接口。特点：
- QQ 官方机器人是这条线的代表，官方出品、稳定、支持扫码一键登录，官方文档在 QQ 接入场景下把它列为推荐项
- 受平台机器人规范约束：功能边界、消息类型、审核规则都由平台定
- 需要在平台开放平台注册机器人拿到凭证
路线二：协议实现端 + 标准协议
以 OneBot v11 协议为代表。OneBot 是一个聊天机器人应用接口标准，目标是统一各平台的机器人开发接口。工作方式：
- 协议实现端（如 NapCat 之于 QQ）负责连接聊天软件本体
- 实现端以反向 WebSocket 把消息推给机器人框架——注意方向：框架是服务端，实现端是客户端
- 只要实现端适配了 OneBot v11 反向 WS，理论上都能接；社区里还有把 Discord、Telegram 桥接进 OneBot 的实现端项目
特点：能力上限高（能做的事比官方机器人 API 多），但账号层面有风控风险，需要自己权衡。
支持的平台清单
官方文档与官网列出的支持范围包括：QQ（官方机器人 + OneBot 两条路）、微信生态（企业微信、微信公众号、企业微信智能机器人等）、飞书、钉钉、Telegram、Discord、Slack、KOOK、Personal 网页对话、VoceChat 等，合计 18+ 平台。每个平台的接入页都在官方文档「消息平台接入」分组下。
怎么选
| 你的情况 | 建议 |
|---|---|
| 就想挂 QQ 群，怕麻烦 | QQ 官方机器人，扫码登录最稳 |
| QQ 群要完整能力（图片、主动消息等） | NapCat + OneBot v11，接受风控自担 |
| 公司用企微 / 飞书 / 钉钉 | 走各家开放平台的应用机器人路线 |
| 个人 TG / Discord 群组 | 对应平台的 Bot API，注册流程最简单 |
| 只想自己网页里用 | 不用接平台，内置 ChatUI 直接满足 |
通用流程预览
不管接哪个平台，动作序列都是：平台侧创建机器人/应用拿凭证 → 面板「机器人」页创建对应类型的实例 → 填凭证或端口 → 两侧保存 → 到日志页确认「适配器已连接」。下面各页逐平台展开，连接失败先看连接排查。