适配器连接
适配器显示连接已断开怎么办？
分别检查适配器两端的主机地址、端口和访问令牌。服务端监听的端口必须与适配器连接的端口一致；如果组件运行在不同容器或不同设备上，127.0.0.1 通常只代表组件自身，不能指向另一台设备或容器。
修改后同时重启适配器和 MaiBot，并查看双方日志确认连接方向。
NapCat 已连接，为什么群聊仍然没有回复？
优先检查宿主适配器策略的放行范围。群聊或私聊不在放行列表时，消息会在进入 MaiBot 前被丢弃。
还应确认 NapCat 登录的 QQ 号、目标群号、机器人发言权限以及 MaiBot 日志中是否实际收到消息。放行范围在 WebUI 的适配器设置或 config/adapter_policy.toml 中配置，具体见统一 QQ 连接器。
应该填写哪个 NapCat Token？
适配器连接 NapCat 时使用的是 NapCat WebSocket 服务配置中的访问令牌。它不是 NapCat WebUI 的登录 Token，也不是 MaiBot WebUI 的访问密码（登录页显示的 Access Token）。
如果 WebSocket 服务没有启用鉴权，适配器对应字段通常留空；如果启用了鉴权，两端必须填写完全相同的值。
SnowLuma 适配器为什么无法连接？
检查插件是否启用、SnowLuma 是否已经启动、server 和 port 是否指向 SnowLuma 的 WebSocket 服务，以及双方 Token 是否一致。SnowLuma 与 MaiBot 不在同一台设备时，还需要确认监听地址、防火墙和网络可达性。
怎样判断问题在适配器还是 MaiBot？
按照消息链路逐段查看日志：平台是否收到消息、适配器是否收到并转换消息、MaiBot 是否收到消息、模型是否生成回复、适配器是否成功发送。在哪一步首次中断，问题通常就位于该步骤或其前一段连接。