部署之前你需要准备的

• 雨云账号（点击注册）
• 正常的的QQ账号
• 大模型提供商账号（例：硅基流动）

开始部署

安装 MaiBot 主程序

成功注册/登录雨云账号后，将进入雨云总览页。

点击云应用卡片，将进入云应用页面，默认会进入云应用的应用商城页。

请在搜索框输入 MaiBot，点击搜索，您将在搜索结果中见到麦麦主程序和适配器.

（附传送门：应用详情（麦麦））

点击麦麦主程序卡片的安装，将进入该应用的应用配置与安装页面.

在该页面无需更改任何内容，直接点击安装应用.

（其实你也可以直接选择服务器分区）

安装 MaiBot NapCat 适配器

回到应用商城页面，重新执行搜索，进入适配器安装页面.

（附传送门：应用详情（适配器））

（安装应用步骤同上）

安装 NapCat

（传送门：应用详情（NapCat））

（搜索NapCat，安装步骤同上）

设置 MaiBot 环境变量

在左侧边栏中点击 “我的项目”，进入项目管理页面.

点击管理按钮，进入你安装应用自动创建的项目，然后跟随图片的指引，依次点击应用管理 -> MaiBot 麦麦，进入 MaiBot 应用的管理页面.

在这里，你可以看到 MaiBot 应用的资源占用信息，此时，你的 MaiBot 应该成功启动了，但我们仍需要进行环境变量配置，让他成功运行.

进入应用的”日志”选项，可以看到最后输出的两行内容，提醒你设置环境变量，以正常使用 MaiBot.

但由于云应用限制，我们需要使用其他方法输入 “confirmed” 运行，但是我们也可以最后两行内容复制出来。框选最后两行内容，右键复制.

2025-09-27T13:13:35.134325414Z 09-27 21:13:35 [confirm] 输入"同意"或"confirmed"或设置环境变量"EULA_AGREE=99f08e0cab0190de853cb6af7d64d4de"和"PRIVACY_AGREE=9943b855e72199d0f5016ea39052f1b6"继续运行

转到应用设置页面，将所复制的环境变量一对一粘贴到变量值输入框中，如图所示.

在粘贴到输入框之后，请点击保存按钮应用更改.

此时会提示重启来应用更改，点击”立即重启“即可。对于 MaiBot 的环境变量设置结束.

设置 MaiBot 的主要参数

转到 MaiBot 的应用管理，这里你可以看到主要的配置文件，以及日志、统计数据等其他文件.

• bot_config.toml （机器人主要行为）的配置教程：🔧 配置指南 | MaiBot 文档中心
• model_config.toml （机器人使用的大模型）的配置指引：🔧 模型配置指南 | MaiBot 文档中心
• env （主要环境变量）的配置指引：MaiBot 配置与安装简介 | MaiBot 文档中心

跟随图片中的箭头指引，你可以编辑这些文件，配置你自己的 MaiBot.

需要注意的是，env文件有一个内容必须更改，因为该文件内容与”服务”项端口映射挂钩，不更改可能导致 适配器 与 MaiBot主程序 的通信失败.

编辑env文件，将

HOST=127.0.0.1

更改为

HOST=0.0.0.0

将适配器连接到 MaiBot

转到”服务”选项，将端口映射箭头后的端口，以及集群内网地址记录下来，比如我这里的端口是 35128 ，集群内网地址是 svc-maibot-core-6rh9pr，复制到记事本暂时保存.

点击顶栏的应用管理，回到已安装的应用界面，点击进入适配器应用的配置界面.

编辑 config.toml 文件，将刚刚复制的内网端口和连接地址对应粘贴进指定位置.

如图所示，点击”保存”，成功保存文件之后，点击重启，重启适配器.

注：允许聊天的设置也在这个文件内，可以顺道一块配置.

（适配器与 MaiBot 连接成功的提示）

将NapCat连接到适配器

回到应用管理，点击服务旁边的按钮，可以直接复制 NapCat WebUI 的登录入口.

点击箭头指向的适配器的按钮，获取适配器的连接URL，比如我这里是

svc-maibot-adapter-napcat-rcqyjq:43551

然后点击 NapCat 卡片，进入日志页面，获取 Token（登录密码）

若直接进入日志页面，显示的是登录二维码，请往上翻。

登录 NapCat 成功后，转到网络配置，新建一个 WebSocket客户端.

URL如何填写？比如我在雨云获取到的url是 svc-maibot-adapter-napcat-rcqyjq:43551

那么，我需要填写的URL就是 ws://svc-maibot-adapter-napcat-rcqyjq:43551/ws

可以理解为，在开头加上 ws://，结尾加上 /ws

websocket客户端的名称可以随便填写，在这里记得复制随机生成的Token，填写至适配的配置文件

（你也可以删除随机生成的Token，自行承担风险）

保存，添加这个websocket客户端.

转到适配器文件管理页面，编辑 config.toml 文件.

如图所示，将host改为0.0.0.0，token填写为在napcat添加websocket客户端随机生成的token.

如果你在添加websocket客户端的时候没有token，那么不填写.

大功告成！

如果要修改允许聊天的群聊和私聊，黑名单或白名单模式，请修改适配器的 config.toml~

如果要修改聊天使用的模型，或者性格，亦或者是聊天频率，请修改 MaiBot 的相关配置文件~

此时你已经完整配置好了MaiBot，享受你的畅聊时光吧~