Windows 部署

更新: 2026/07/30字数: 0 字时长: 1 分钟

系统要求

Windows 10 及以上版本，至少 2GB 可用内存。

一键包

推荐大多数用户使用一键包部署。一键包是一个桌面应用，会自动帮你管理 MaiBot 的安装、更新、启动和配置。

MaiBot OneKey前往 GitHub 下载最新版本的一键包

也可以加入 QQ 群，从群文件获取，详见交流群。

下载后双击安装包，按提示完成安装。首次启动时，一键包会自动配置 Python 环境并安装运行依赖，随后弹出配置向导，跟着提示完成即可。

TIP

遇到问题可以先看看常见问题，大部分常见情况都有覆盖。

源码部署

如果你更习惯用命令行，或者想参与开发，可以用源码部署。

需要先装好 Python 3.12+ 和 Git。

安装 uv：

PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆仓库：

git clone https://github.com/Mai-with-u/MaiBot.git

进入文件夹，安装依赖：

uv sync

uv sync

pip install

pip install -r requirements.txt

启动：

Bash

uv run bot.py

第一次启动会要求同意用户协议，在终端输入「同意」即可。

进入 WebUI

启动后，MaiBot 会自动打开 WebUI 服务。打开浏览器，访问以下地址：

http://localhost:8001

首次启动时，终端会打印出 WebUI 的登录 Token，类似于这样：

07-30 18:53:45 [WebUI] WebUI 配置文件不存在，正在创建: /MaiMBot/data/webui.json
07-30 18:53:45 [WebUI] WebUI 配置已保存到: /MaiMBot/data/webui.json
07-30 18:53:45 [WebUI] 新的 WebUI Token 已生成: QSwgc2Vu...
07-30 18:53:45 [WebUI应用] 🔑 WebUI 登录 Token: QSwgc2VucGFp77yBQ2lhbGxv772eKOKIoOODu8+JPCAp4oyS4piF
07-30 18:53:45 [WebUI应用] 💡 请使用此 Token 登录 WebUI
07-30 18:53:45 [WebUI服务] 🌐 WebUI 服务器启动中...

复制日志中的 Token，在浏览器登录页面粘贴即可进入 WebUI。后续可以在 data/webui.json 中查看或修改 Token。

进入 WebUI 后，跟随配置向导完成模型配置和平台连接即可。

配置模型和连接 QQ 的详细步骤，参考 模型配置 和 适配器。