MaiMBot 文档中心

Appearance

部署麦麦（main 0.6版） ​

WARNING

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

系统要求 ​

python >= 3.10

OS: Windows10 或 Windows11

部署步骤 ​

一、环境配置 ​

两种方式任选其一

Conda 版 ​

假定你已经安装好了Conda，只需要创建一个python版本大于等于3.10的虚拟环境即可 然后我们创建一个安装麦麦的文件夹（以MaiM-with-u为例）

shell
conda create -n MaiBotEnv python=3.12
conda activate MaiBotEnv
mkdir MaiM-with-u

虚拟环境版 ​

首先，在官网下载python，并安装大于等于3.10的版本并添加系统变量。 随后执行以下操作

  1. 新建一个你想要安装麦麦的文件夹（以MaiM-with-u为例）
  2. 进入文件夹，创建python虚拟环境并激活
shell
mkdir MaiM-with-u
cd MaiM-with-u
python -m venv MaiBotEnv
.\\MaiBotEnv\\Scripts\\activate

二、获取必要的文件 ​

  1. 通过 git clone 将 麦麦 repo clone 到本地

  2. 通过 git clone 将 maim_message 包 clone 到本地

  3. 通过 git clone 将 MaiBot-Napcat-Adapter clone 到本地

shell
git clone https://github.com/MaiM-with-u/MaiBot.git
git clone https://github.com/MaiM-with-u/maim_message.git
git clone https://github.com/MaiM-with-u/MaiBot-Napcat-Adapter.git

三、依赖安装 ​

  1. 进入下载的麦麦repo文件夹
  2. pip安装所需依赖
shell
cd MaiBot
pip install -i https://mirrors.aliyun.com/pypi/simple -r .\\requirements.txt
  1. 随后回到上一级文件夹（此处为MaiM-with-u），再进入maim_message文件夹，安装这个包
shell
cd ..
cd maim_message
pip install -e .
  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

四、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
├── maim_message
└── 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
如果你想修改这个PORT为其他，点开这里

找到 MaiBot-Napcat-Adapter 下的 config.toml ，打开，修改 MaiBot_Server 字段中的 port 为你想要的端口号

  1. 剩余的内容参考配置指南

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相同
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字段

七、运行 ​

首先启动Napcat

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

shell
python ./bot.py

然后打开一个新的窗口，进入Adapter的文件夹，运行

shell
python ./main.py