接入平台
适配器负责把 QQ、邮件、语音通话等消息平台接进 MaiBot。 在 MaiBot 里，适配器本身就是插件——安装、启用和管理都在插件管理里完成，装好后去插件设置里填连接信息即可。
接 QQ 之前，先选一条路线
QQ 有两条接入路线，按你的条件选一条即可：
- 本地客户端登录 — 用你自己的 QQ 号登录（SnowLuma 或 NapCat），功能最全，推荐统一 QQ 连接器：一个插件同时支持两类客户端，连接后自动识别；
- 开放平台机器人 — 去 QQ 开放平台申请机器人（AppID + AppSecret），不需要登录任何 QQ 客户端。
两条路线互不冲突，可以同时启用；开放平台路线还可以通过统一 ID 绑定与本地客户端路线共享数据。
1.3.0 的适配器变化
MaiBot 1.3.0 起，原 SnowLuma 适配器与 NapCat 适配器已合并为统一 QQ 连接器（MaiBot-SnowLuma-Adapter），独立的 NapCat 适配器停止演进并归档。升级主程序后请同步升级适配器，旧配置会在加载时自动迁移。
同时，适配器内置的群聊 / 私聊黑白名单已移除，入站通行统一由 MaiBot 的适配器策略（config/adapter_policy.toml + WebUI 适配器设置）控制。
可用适配器一览
维护方标注 — 🏛️ 官方：Mai-with-u 组织维护；🌐 社区：第三方作者维护。
QQ（本地客户端登录）
- QQ 本地客户端 — 🏛️ 官方维护。统一 QQ 连接器：登录你自己的 QQ 号，一个插件同时支持 SnowLuma / NapCat，连接后自动识别
- NapCat — 已归档。原独立 NapCat 适配器已并入统一 QQ 连接器，本页仅作历史参考
QQ（开放平台机器人）
- QQ 官方机器人 — 🏛️ 官方维护。AppID + AppSecret 直连 QQ 开放平台，支持单聊与群聊的文本、@、图片、表情
邮件、iMessage 与语音通话
- 邮件 — 🌐 社区维护。IMAP 收信 + SMTP 回复，把专用机器人邮箱接入 MaiBot
- QQ 语音通话 — 🌐 社区维护。为 QQ 增加实时语音通话入口，电话里的麦麦复用同一套人设与记忆
- iMessage — 🌐 社区维护。通过 Photon 云端服务接入 Apple iMessage，无需自备 Mac
社区适配器
社区适配器由各自作者持续维护，安装前可以看一眼仓库的更新时间与 README，确认与当前 MaiBot 版本兼容。
配置连接的一般套路
适配器通常要配置两类连接：
- 消息平台 → 适配器 — 例如 SnowLuma / NapCat 登录 QQ 并把消息推给适配器；开放平台机器人则需先在 QQ 开放平台申请账号。
- 适配器 → MaiBot — 插件版适配器一般不需要额外配置这一层，只有独立版才需要。
具体怎么申请平台账号、填哪些地址和 Token，见各适配器文档。
先加名单，再测试
新适配器接入后，第一件事是确认放行范围：MaiBot 主程序在 config/adapter_policy.toml 里有一套统一的群聊 / 私聊访问策略（默认全部放行），WebUI 的适配器设置提供可视化编辑。先在策略里放行一个测试群和一个测试用户，再测试收发；排查「没反应」时，这一层是第一现场，入口见 适配器管理。
统一 QQ 连接器与 QQ 官方机器人适配器均不带内置聊天名单，放行范围只看这一层。
验证与排错
向对应平台发一条测试消息：
- MaiBot 后台能看到消息日志、且能正常回复 → 成功；
- 没反应时按序检查：平台客户端是否登录 → 适配器是否启动 → 是否连上平台 →（独立版）是否连上 MaiBot → MaiBot 的适配器策略是否放行该群 / 用户 → MaiBot 是否就绪。