跳到主要内容

在浏览器里改配置

不用编辑文件,在 WebUI 里点点鼠标就能改 MaiBot 的设置。侧边栏「麦麦配置编辑」分组下的 麦麦设置/config/bot)编辑 bot_config.toml模型管理/config/model)编辑 model_config.toml

麦麦设置

打开「麦麦设置」页,顶部有四个编辑模式:

麦麦设置

核心设置

日常最常用的几项:人格配置(性格、说话风格)、表达方式行为风格。每个设置项都有说明文字,下拉菜单、开关、输入框直接操作。

详细设置

完整的分节表单,覆盖 bot_config.toml 的所有配置节(聊天、记忆、表情包、语音、MCP 等)。不确定的选项悬停鼠标看说明。

详细设置

命令管理

查看所有已注册的插件命令并配置执行权限,见命令管理

源文件

直接编辑 bot_config.toml 原文,适合懂 TOML 的用户:

源文件编辑

保存时系统会检查格式,有错会提示;保存成功后按下方规则生效。

模型管理

「模型管理」页管理模型服务商、模型和任务分配:

模型管理

  • 模型设置 — 左侧选择服务商,右侧编辑 API 地址、Key 和模型列表,可点「测试连接」验证
  • 功能分配 — 把思考、回复、视觉等任务分配给具体模型

功能分配

  • 配置副本 — 保存当前配置副本、管理历史副本,方便回滚

保存与生效

表单模式改动后自动保存(约 2 秒防抖),也可以点保存按钮手动保存。配置写入文件后由 MaiBot 的配置监听器重新加载。

后续请求自动使用新值 — 人格、聊天策略、回复频率、模型服务商、模型和任务分配等运行时配置。

需要完整重启 MaiBot — WebUI 的启用状态、监听地址和端口,maim_message 的监听与鉴权,MCP 连接,以及插件运行时自身的进程级设置。

插件自己的配置由插件生命周期管理,通常会热更新。完整边界见配置文件

修改建议

新手推荐

  • 先改机器人名字签名,让机器人有个性
  • 回复速度,太快太慢都不好
  • 试试人格设置,让机器人更有趣

进阶玩法

  • 配置多个 AI 模型,不同任务用不同模型
  • 设置关键词回复,让机器人更智能
  • 调整记忆参数,记住更多聊天内容

验证与排错

验证:改一个设置(如机器人昵称),保存后刷新页面,值还在说明写入成功。

保存失败?

  • 源文件模式检查 TOML 格式,看错误提示定位行号
  • 表单模式看字段旁的红色提示,按提示修正

改了没生效?

  • 运行时配置在下一次处理或请求中生效,稍等再试
  • 监听端口、MCP 连接等启动项需要完整重启 MaiBot

改坏了怎么办?

  • 源文件模式改回原来的值再保存
  • 或直接编辑 config/bot_config.toml 恢复

相关文档