MaiBot 文档中心

Appearance

📦 Windows 部署 ​

WARNING

本教程为部署到QQ平台的教程，不代表其他平台的部署方式相同

TIP

高版本（0.6.3+）版本启用了新版知识库，使用说明在这里

系统要求 ​

python >= 3.10

OS: Windows10 或 Windows11

部署步骤 ​

一、获取必要的文件 ​

  1. 创建 MaiM-with-u 文件夹并进入
  2. 通过 git clone 将 麦麦 repo clone 到本地
  3. 通过 git clone 将 MaiBot-Napcat-Adapter clone 到本地
shell
mkdir MaiM-with-u
cd MaiM-with-u
git clone https://github.com/MaiM-with-u/MaiBot.git
git clone https://github.com/MaiM-with-u/MaiBot-Napcat-Adapter.git

一、环境配置 ​

两种方式任选其一

Conda 版 ​

假定你已经安装好了Conda，只需要创建一个python版本大于等于3.10的虚拟环境即可。

shell
conda create -n MaiBotEnv python=3.12
conda activate MaiBotEnv

虚拟环境版 ​

  1. 首先，在官网下载python，并安装大于等于3.10的版本并添加系统变量。
  2. 随后在 MaiM-with-u 文件夹创建Python虚拟环境并激活
shell
python -m venv MaiBot\venv
.\MaiBot\venv\Scripts\activate

三、依赖安装 ​

  1. 进入下载的麦麦repo文件夹
  2. pip安装所需依赖
shell
cd MaiBot
pip install -i https://mirrors.aliyun.com/pypi/simple -r .\requirements.txt --upgrade

TIP

如果你在这里发现quick_algo安装失败，请参考LPMM 使用说明中手动编译的部分

  1. 随后回到上一级文件夹（此处为MaiM-with-u），再进入MaiBot-NapCat-Adapter文件夹，安装依赖
shell
cd ..
cd MaiBot-Napcat-Adapter
pip install -i https://mirrors.aliyun.com/pypi/simple -r .\requirements.txt --upgrade

四、Napcat adapter 部署 ​

打开你的文件夹（这里是Maim-with-u文件夹下的MaiBot-Napcat-Adapter文件夹），找到template下的template_config.toml复制到Adapter的根目录，改名为config.toml

最终部署完成后的文件夹结构应该类似这样：

Maim-with-u
├── MaiBot
│   ├── changelogs
│   ├── config
│   ├── data
│   ├── depends-data
│   ├── src
│   │   └── ...
│   └── template
└── MaiBot-Napcat-Adapter
    └── ...

五、Napcat 部署 ​

六、配置 MaiBot 和 Adapter ​

MaiBot配置 ​

  1. 在MaiBot文件夹中新建一个config文件夹，手动复制template文件夹中的bot_config_template.toml到config目录下并改名为bot_config.toml
  2. 然后手动复制template文件夹中的template.env到根目录并重命名为.env
  3. 打开.env并修改PORT为8000
  4. 剩余的内容参考配置指南

MaiBot Napcat adapter 配置 ​

  1. 在Napcat中新建websocket客户端并设置反向代理的url（这里以ws://localhost:8095/为例）

IMPORTANT

配置示例：

  1. 打开MaiBot-Napcat-Adapter文件夹下的config.toml，配置[Napcat_Server]、[MaiBot_Server]、[Napcat]字段
    • [Napcat_Server]字段的port,应该与Napcat设置的反向代理的url相同（这里是8095）
    • [Napcat_Server]字段的heartbeat,应该与Napcat设置的反向代理的心跳间隔相同（注意，Napcat中的间隔为毫秒，填入时请转化为秒，这里是30）
    • [MaiBot_Server]字段的port,应该与麦麦本体的.env中的PORT相同（此处为8000）
toml
[Napcat_Server] # Napcat连接的ws服务设置
host = "localhost" # Napcat设定的主机地址
port = 8095        # Napcat设定的端口
heartbeat = 30     # 与Napcat设置的心跳相同（按秒计）

[MaiBot_Server] # 连接麦麦的ws服务设置
platform_name = "qq" # 标识adapter的名称（必填）
host = "localhost"   # 麦麦在.env文件中设置的主机地址，即HOST字段
port = 8000          # 麦麦在.env文件中设置的端口，即PORT字段
  1. 其余字段请参考 Napcat Adapter 的配置指南

七、运行 ​

  1. 首先启动Napcat

  2. 随后进入麦麦本体的文件夹，运行

shell
# 因为已经激活虚拟环境，无需再次激活
# .\venv\Scripts\activate
python .\bot.py
  1. 然后打开一个新的窗口，进入Adapter的文件夹，运行
shell
#激活在Maibot文件夹下的虚拟环境
..\Maibot\venv\Scripts\activate
python .\main.py