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