AstrBot 文档AstrBot 接入指南：部署完成后，下一步如何接到聊天平台
帮助你理解 AstrBot 的平台接入到底是什么、接入前要准备什么，以及 QQ、微信和通用 Webhook 路线各自更适合谁。
这篇适合谁
这篇给已经完成部署、准备把 AstrBot 接入真实聊天平台的用户。
先说明边界
本页解决“先走哪条接入路线”与“如何判断是否接通”，不覆盖 18+ 平台的全部实现差异。
接入前先准备什么
- 明确首个平台的真实使用目标，不要一次并行多平台。
- 确认平台侧账号、权限、审核或前置服务已经准备完成。
- 确认部署环境具备回调网络、端口、日志与权限检查能力。
3 条高频接入路线怎么选
QQ 路线
适合以 QQ 社群为核心场景的用户。通常文档与社区经验较丰富，但生态更新节奏也较快。
微信路线
适合围绕微信私域或团队沟通场景。需要更关注平台限制、策略变化和长期维护成本。
通用 Webhook / 官方平台路线
适合希望先打通标准化接口、后续再扩展到更多平台的团队。路径更通用，但前置网络要求更明确。
接入时最容易卡住的地方
- 平台侧前置准备没做完，就开始本地调试。
- 回调地址、网络连通性或权限边界不满足。
- 误以为安装成功就等于平台一定能接通。
- 路线选错，导致后续排错成本持续增高。
什么算接入成功
满足下面 3 条即可认为首个平台接入达标：
- 可以稳定接收平台消息。
- 可以稳定回发消息，且关键流程可重复。
- 平台权限与风险边界经过实际验证，不依赖临时放权。