❓ 常见问题

新手最容易遇到的问题，都在这里了！

💰 费用相关

MaiBot 需要花钱吗？

答：MaiBot 本身是免费的，但 AI 模型要花钱。

具体情况：

💡 MaiBot 软件 - 完全免费，开源的
💳 AI 模型 - 要付费，比如 DeepSeek、OpenAI 等
📊 大概费用 - 聊天不多一个月几块钱就够了

省钱技巧：

用便宜的模型（DeepSeek 很便宜）
设置回复频率限制
关闭不必要的功能

用什么 AI 模型最好？

推荐：新手用 DeepSeek，便宜又好用！

对比：

模型	价格	效果	推荐度
DeepSeek	⭐ 很便宜	⭐⭐⭐⭐ 很好	⭐⭐⭐⭐⭐ 强烈推荐
千问	⭐⭐ 便宜	⭐⭐⭐⭐ 很好	⭐⭐⭐⭐ 推荐
GPT-4o-mini	⭐⭐⭐ 中等	⭐⭐⭐⭐ 很好	⭐⭐⭐ 可以试试

QQ 号会被封吗？

答：有风险，但可以用小号避免。

建议：

🔒 用小号 - 不要用主号，降低风险
⚠️ 注意言行 - 不要说违规内容
🛡️ 分散风险 - 多个小号轮换使用

🚀 使用问题

启动不了怎么办？

常见原因和解决：

1️⃣ Python 版本不对

# 检查版本
python --version
# 需要 3.12 以上

2️⃣ 配置文件缺失

# 第一次启动会自动创建
# 如果没有，手动创建 config 文件夹

3️⃣ 端口被占用

启动报错示例：

WebUI 服务器 启动失败: 端口 8001 已被占用 (host=127.0.0.1)

方法一：改端口 — 编辑 config/bot_config.toml：

WebUI 端口：[webui] → port = 8002
WebSocket 端口：[maim_message] → ws_server_port = 8001（默认 8000，冲突时改为其他端口）

方法二：关进程：

bash

# Windows
netstat -ano | findstr :8001
taskkill /PID <PID> /F

# Linux/macOS
lsof -i :8001
kill -9 <PID>

机器人不回复消息？

检查步骤：

看日志 - 有没有报错信息？
检查配置 - API Key 填对了没？
测试连接 - 网络能访问模型服务吗？
看权限 - QQ 群里有发言权限吗？

常见错误：

❌ API Key 错了 → 401 错误
❌ 网络不通 → 连接超时
❌ 被禁言了 → 发不出消息

配置文件格式错误？

新手建议：

🖥️ 用 WebUI 改配置 - 不会出错
✏️ 手动编辑要小心 - 符号都要对
💾 改前备份 - 错了还能恢复

格式要点：

toml

# 字符串要加引号
name = "我的机器人"

# 数字不要引号
port = 8001

# 布尔值小写
enabled = true

🤖 功能问题

可以同时服务多个群吗？

答：当然可以！一个 MaiBot 可以服务很多群。

设置方法：

在配置里添加多个群号
每个群可以不同性格
统一管理很方便

数据存在哪里？安全吗？

答：所有数据都存在你自己的电脑上。

存储位置：

💾 聊天记录 - 本地数据库
🧠 记忆内容 - 本地文件
⚙️ 配置文件 - 本地磁盘

安全提醒：

🔒 不会上传网络 - 数据都在本地
🏠 隐私保护好 - 别人看不到
💿 定期备份 - 防止丢失

MaiBot 支持手机部署吗？

答：理论上可以，但不推荐。

原因：

📱 手机性能有限 - 运行可能卡顿
🔋 耗电量大 - 手机发热严重
📶 网络不稳定 - 容易掉线

建议：

🖥️ 用电脑 - 台式机、笔记本都行
☁️ 用云服务器 - 24 小时在线
🏠 树莓派 - 小型设备也可以

一定要用 QQ 吗？可以用别的平台吗？

答：目前主要支持 QQ，其他平台在开发中。

现状：

✅ QQ - 支持最好，功能最全
🚧 微信 - 目前尚无可用适配器，欢迎社区开发
📋 其他 - 可通过适配器插件接入更多平台

🔧 技术问题

回复太慢怎么办？

优化方法：

换快模型 - DeepSeek 响应很快
减少上下文 - 不要给太多历史记录
检查网络 - 网络慢会影响速度
关闭不必要功能 - 插件太多会拖慢速度

NapCat 已连接，但群聊收不到消息？

优先检查 NapCat 适配器的群聊名单过滤。

NapCat 适配器默认启用聊天名单过滤，群聊默认是白名单模式。群号不在 group_list 中时，群消息会被适配器直接丢弃。

处理方法：

打开 plugins/MaiBot-Napcat-Adapter/config.toml
Docker 部署则打开 ./data/MaiMBot/plugins/MaiBot-Napcat-Adapter/config.toml
在 [chat] 中把目标群号加入 group_list
建议临时打开 show_dropped_chat_list_messages = true，方便在日志里看到被过滤的消息
保存后重启 MaiBot

toml

[chat]
enable_chat_list_filter = true
show_dropped_chat_list_messages = true
group_list_type = "whitelist"
group_list = ["你的QQ群号"]

内存占用太高？

节省内存：

📉 减少记忆容量 - 少记一些东西
🗑️ 清理无用数据 - 定期删除垃圾
🔌 少用插件 - 插件会占内存
💻 升级配置 - 加内存条最直接

想换 AI 模型怎么换？

简单步骤：

打开 WebUI → 配置管理
找到模型设置
选择新模型
保存后立即生效

💡 新手建议

第一次用要注意什么？

先用小号测试 - 避免主号风险
从简单配置开始 - 不要一次开太多功能
多看日志 - 有问题日志会告诉你
加入交流群 - 有问题可以问别人

怎么让机器人更聪明？

教它知识 - 用记忆管理功能
调人格设置 - 让性格更鲜明
装有用插件 - 增加各种能力
多和它聊天 - 它会越学越聪明

哪里能学到更多？

📖 看文档 - 这个文档网站
💬 加群组 - 和其他用户交流
🔍 搜教程 - 网上有很多经验分享
🐱 看 GitHub - 最新的更新和讨论

🆘 遇到解决不了的问题？

获取帮助的途径：

先看 FAQ - 可能已经有答案
看日志 - 错误信息很重要
搜一搜 - 网上可能有人遇到过
问一问 - 加群问其他用户
提 Issue - GitHub 上提交问题

提问时要提供的信息：

🖥️ 系统信息 - Windows/Linux/Mac？
📋 错误日志 - 具体的报错信息
⚙️ 配置信息 - 相关配置内容
🔢 版本信息 - MaiBot 版本号
🎯 复现步骤 - 怎么操作会出错

❓ 常见问题 ​

💰 费用相关 ​

MaiBot 需要花钱吗？ ​

用什么 AI 模型最好？ ​

QQ 号会被封吗？ ​

🚀 使用问题 ​

启动不了怎么办？ ​

机器人不回复消息？ ​

配置文件格式错误？ ​

🤖 功能问题 ​

可以同时服务多个群吗？ ​

数据存在哪里？安全吗？ ​

MaiBot 支持手机部署吗？ ​

一定要用 QQ 吗？可以用别的平台吗？ ​

🔧 技术问题 ​

回复太慢怎么办？ ​

NapCat 已连接，但群聊收不到消息？ ​

内存占用太高？ ​

想换 AI 模型怎么换？ ​

💡 新手建议 ​

第一次用要注意什么？ ​

怎么让机器人更聪明？ ​

哪里能学到更多？ ​

🆘 遇到解决不了的问题？ ​

获取帮助的途径： ​

提问时要提供的信息： ​