适配器连接
适配器显示连接已断开怎么办？
分别检查适配器两端的主机地址、端口和访问令牌。服务端监听的端口必须与适配器连接的端口一致；如果组件运行在不同容器或不同设备上，127.0.0.1 通常只代表组件自身，不能指向另一台设备或容器。
修改后同时重启适配器和 MaiBot，并查看双方日志确认连接方向。
NapCat 已连接，为什么群聊仍然没有回复？
优先检查 NapCat 适配器的聊天过滤。白名单模式下，群号不在名单中时，消息会在进入 MaiBot 前被丢弃。
还应确认 NapCat 登录的 QQ 号、目标群号、机器人发言权限以及 MaiBot 日志中是否实际收到消息。具体配置见NapCat 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 是否收到消息、模型是否生成回复、适配器是否成功发送。在哪一步首次中断，问题通常就位于该步骤或其前一段连接。