常见问题
这里收录使用 MaiBot 时经常遇到的问题。请先按问题所属分类查找；如果日志中已经出现明确错误代码，可以直接前往错误排查。
问题分类
基础使用 — 费用、支持平台、首次使用和获取帮助。
部署与启动 — 启动失败、配置文件、端口和 WebUI。
一键包 — 安装位置、用户数据、实例迁移和连接检查。
适配器连接 — NapCat、SnowLuma、聊天过滤和连接参数。
聊天与回复 — 发言频率、自我回复、连续消息和回复分割。
模型与 API — API Key、模型标识符、视觉模型和 embedding。
记忆与学习 — 长期记忆、关系向量、错误记忆、表达与黑话。
插件问题 — 插件启用、命令冲突、下载失败和故障定位。
数据与迁移 — 备份范围、迁移步骤和恢复检查。
快速排查
遇到问题时，建议依次确认：
- 记录 MaiBot、一键包和适配器的版本。
- 查看问题发生时前后的完整日志，不要只截取最后一行。
- 确认最近修改过的配置、模型和插件。
- 按对应分类执行检查；有明确报错时查询错误排查。
- 仍无法解决时，携带版本、日志、相关配置和复现步骤反馈。
内容来源
部分问答根据社区协作文档《麦麦教程-常见问题速查/社区教程》整理而来，在此，感谢各位作者对 MaiBot 的支持！
本站没有直接照搬原文，而是结合当前 MaiBot 配置和代码重新核对、修正并分类。