登录与设置

更新: 2026/10/06字数: 2190 字时长: 7 分钟

MaiBot 自带浏览器管理面板（WebUI），启动后访问 http://localhost:8001 就能改配置、管记忆、看统计。这一页讲怎么登录、怎么完成首次设置，以及忘记密码怎么办。

获取登录密码

第一次启动 MaiBot 时，控制台会打印一个临时 Token：

🔑 WebUI 登录 Token: e37fd618051f802816dc3bf32067583294b2648aff233a2d4caee0f67ebfdfcb
💡 请使用此 Token 登录 WebUI

这个 Token 只用于本次启动的首次登录。登录后，首次配置向导会要求你设置一个固定 Token；临时 Token 在下次启动时会重新生成。

登录

1. 浏览器打开 http://localhost:8001，进入登录页
2. 输入控制台显示的 Token，点击「登录」

1.3.1 起重做了登录页样式：左对齐的紧凑卡片、命令行风格的标题前缀，输入框占位符与帮助弹窗统一改称「访问密码」（WebUI 设置 → 安全里仍写作 Access Token，两种叫法指同一个东西）。

3. 首次登录会进入配置向导，第一步是设置固定 Token

固定 Token 需要同时满足：长度至少 10 位、包含大写字母、包含小写字母、包含特殊符号（例如 MaiBot-Docs-2026!）。

4. 保存后旧 Token 立即失效，用新 Token 重新登录，再继续向导

首次配置向导

向导共三步，任何一步都可以点「跳过向导」（之后可在「麦麦设置 → WebUI 设置 → 其他」里重新运行）：

设置登录密码

把临时 Token 换成你自己的固定 Token。

基础与人格

设置机器人昵称、人格描述和回复风格。

API 与模型

配置模型服务商（API 地址、Key）和基础模型。还没有 Key 可以先跳过，之后在模型管理里补。

完成后进入管理面板首页：

能做什么？

• ⚙️ 改配置 — 表单化编辑 bot_config.toml，不用碰文件
• 🧠 管记忆 — 查看、导入、修正、删除长期记忆
• 🔌 装插件 — 安装和管理插件、适配器
• 💬 直接聊天 — 和麦麦对话、围观真实群聊的推理过程
• 📊 看统计 — 消息、Token、费用与在线时长

界面导航

1.3.2 起重排了左侧侧边栏，入口按用途分成四组：

• 配置管理 — 麦麦设置（bot_config.toml）、模型管理（model_config.toml）、适配器设置（账号与黑白名单）
• 资源管理 — 表情包、表达方式、黑话、行为学习、长期记忆
• 扩展集成 — 插件扩展（原「插件管理」）、插件市场
• 高级工具 — Prompt 管理、回复效果、数据管理、详细统计数据、日志查看器

两处入口变化需要知道：

• WebUI 设置是独立页面（/settings），点顶栏右侧的齿轮按钮进入，手机上在顶栏菜单里。1.3.2~1.3.3 它曾内嵌在「麦麦设置」的第三个标签里，1.3.4 搬了回来；那段时间收藏的 /config/bot?mode=webui 会自动跳到 /settings
• 侧边栏的 MCP 设置 独立入口已移除，MCP 服务管理并入「扩展集成 → 插件扩展」页里的 MCP 服务 分组；打开旧地址 /mcp-settings 会跳转到插件扩展页

基本设置

在 bot_config.toml 里改 WebUI 的设置：

TOML

[webui]
enabled = true                # 是否启用 WebUI
host = ["127.0.0.1", "::1"]  # 绑定地址列表
port = 8001                   # 端口号
mode = "production"           # 运行模式：development(开发) 或 production(生产)
webui_style = 2               # 界面风格：0 原版 / 1 未来复古 / 2 千禧（1.3.2 起开放）
anti_crawler_mode = "basic"   # 防爬虫模式：false / strict / loose / basic
allowed_ips = "127.0.0.1"     # IP 白名单（逗号分隔）

• host 改成 ["0.0.0.0", "::"] 可以监听所有网卡；同时应配置防火墙、访问白名单和 HTTPS
• port 可以改成其他数字避免冲突

WebUI 设置

WebUI 自身的界面偏好、登录 Token 和维护操作都收在 WebUI 设置 里：点顶栏右侧的齿轮按钮进入（地址 /settings）。

• 外观 — 主题模式（浅色 / 深色 / 跟随系统）、主题色、字体、圆角、自定义 CSS，以及界面风格（原版 Dashboard / 未来复古 / 千禧）
• 安全 — 修改或重新生成登录 Token
• 其他 — 清理日志与缓存、导入 / 导出设置、重新运行安装向导、重置
• 关于 — 版本信息、技术栈与开源许可

界面风格

「外观」标签顶部的「界面风格」是三选一：

• 原版 Dashboard — 保留卡片、圆角、背景和自定义主题能力，对应 webui_style = 0
• 未来复古 — 一键包外壳同款纸面颗粒、硬朗描边和切角面板，对应 webui_style = 1
• 千禧（1.3.2 新增）— 米黄塑料机壳、键帽按钮和下沉屏幕，夜间模式是关灯后的炭灰机壳，对应 webui_style = 2。侧边栏常驻不折叠，首页图表变成示波屏样式

千禧是 1.3.2 才开放的取值：webui_style = 2 写在 1.3.1 的 bot_config.toml 里会校验失败。

千禧风格换字体 — 选了千禧后，「外观」里多出两组像素字体：「英文与数字」和「中文」各挑一种，点了立刻生效。选择只存在当前浏览器里，换浏览器要重新选。

自定义主题只在原版下可见

主题色、界面样式微调（字体、视觉效果、布局、动画、背景）和主题导入 / 导出只在「原版 Dashboard」下显示；切到「未来复古」或「千禧」后这些区块会隐藏。

样式选择会写回 bot_config.toml 的 [webui].webui_style，多个浏览器同时打开 WebUI 时会互相覆盖本地的选择，以最后一次切换为准。

把常用设置页钉在顶部

「麦麦设置」的栏目很多。1.3.3 起，页面标题旁边是一个下拉列表，所有栏目都在里面，不再分「展开 / 收起」。

1.3.4 起，常去的栏目还可以钉住：打开下拉列表，点栏目右边的图钉，它就会固定在标题右侧，以后一点就到。再点一次图钉取消。

钉固记录只存在当前浏览器里，换浏览器或清缓存后需要重新钉。

真实聊天流快捷管理

麦麦聊天（/chat）从 1.3.0 起放进侧边栏「概览」分组，不再占顶部工作区的标签；顶部工作区只剩 麦麦 和 日志 两个。页面左侧会话列表分两类：

• 与麦麦聊天 — 本地会话，含默认会话和虚拟身份会话。
• 麦麦的聊天流 — 数据库里的真实群聊 / 私聊，带最新一条消息预览、当前阶段与在线状态；点开后在右侧看该会话的麦麦观察时间线。
• 搜索框 — 按名称过滤两类会话，没有匹配结果时会明确提示。

直达设置入口：观察聊天流每项右侧有专属的 ⚙️ 齿轮 图标，点击后在当前页弹出聊天流设置浮层（1.3.0 前会跳转到聊天管理页），包含：

• Session 基本信息 — Session ID、平台、类型、群号 / 用户 ID
• 适配器规则 — 放行或拒绝该会话下的具体适配器
• 发言频率规则 — 按时间段配置默认频率与动态频率
• 额外聊天流 Prompt — 为这个会话追加专属 Prompt
• 学习配置 — 表达、黑话、行为的启用状态与修正
• 删除聊天流 — 需手动输入完整 session_id 的严肃确认

本地用户身份

麦麦聊天的输入框右侧是本地用户身份框（1.3.1 起从侧边栏移到此处），头像和昵称在同一个框里改：

• 改昵称 — 点昵称旁的铅笔图标，输入新昵称后回车或点「保存」；留空保存时回退为默认昵称
• 换头像 — 点头像右下角的相机图标上传图片，支持 JPEG、PNG、WebP、GIF、BMP

更完整的聊天与统计说明见聊天记录和统计。

忘记密码怎么办？

如果仍能登录，在「麦麦设置 → WebUI 设置 → 安全」中修改或重新生成 Token：

如果已经无法登录：

1. 关闭 MaiBot
2. 删除 data/webui.json 文件
3. 重新启动 MaiBot，用控制台显示的新临时 Token 登录，并重新设置固定 Token

验证与排错

验证：登录后能看到首页统计卡片和左侧菜单，说明 WebUI 正常。

打不开页面？

• 确认 MaiBot 正在运行，控制台打印了「🌐 WebUI 服务器启动中...」和「🌐 访问地址」
• 确认 [webui].enabled = true，端口没被占用

登录提示 Token 错误？

• 临时 Token 每次启动都会变，用本次启动控制台打印的值
• 复制时别带上空格或换行

设置固定 Token 后进不去？

• 保存固定 Token 后旧 Token 立即失效，用新 Token 重新登录
• 实在不行删除 data/webui.json 重置

收藏的 /settings 地址跳到 /config/bot 了？

• 1.3.4 起 WebUI 设置在独立页面 /settings，点顶栏右侧的齿轮进入；旧地址 /config/bot?mode=webui 会自动跳过去
• 想直接进某个子标签，用 /settings?tab=security（可选 security / other / about，不带参数就是外观）；想进 MCP 服务，走「扩展集成 → 插件扩展」

更多功能

• 配置管理 - 在浏览器里改配置
• 适配器管理 - 账号身份与黑白名单
• 命令管理 - 插件命令与执行权限
• 记忆管理 - 查看和管理记忆
• MCP 配置 - 外部工具服务，入口在「插件扩展 → MCP 服务」
• 插件管理 - 安装和管理插件
• 聊天记录 - 查看聊天统计
• 数据管理（/data-transfer）- 侧边栏「高级工具 → 数据管理」，打包导出和导入整份数据