Windows部署步骤

根据文档一步步走即可 📦 Windows 部署 | MaiBot 文档中心

下面说明些注意事项,标题结构依据官方文档。

环境配置

安装 uv

如果 pip 提示不存在,请直接去 Download Python | Python.org 重新安装 python,比自己折腾环境变量更省事

NapCat adapter 部署

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

注意是部署后,所以如果发现缺失某些文件夹,可能是运行时会自动生成的。

MaiBot Napcat Adapter 文档 | MaiBot 文档中心

记得修改 MaiBot-Napcat-Adapter\config.toml 中的 group_listprivate_list

[chat] # 黑白名单功能
group_list_type = "whitelist" # 群组名单类型,可选为:whitelist, blacklist
group_list = [填写数字(int)]               # 群组名单
# 当group_list_type为whitelist时,只有群组名单中的群组可以聊天
# 当group_list_type为blacklist时,群组名单中的任何群组无法聊天
private_list_type = "whitelist" # 私聊名单类型,可选为:whitelist, blacklist
private_list = [填写数字(int)]               # 私聊名单
# 当private_list_type为whitelist时,只有私聊名单中的用户可以聊天
# 当private_list_type为blacklist时,私聊名单中的任何用户无法聊天
ban_user_id = []   # 全局禁止名单(全局禁止名单中的用户无法进行任何聊天)
ban_qq_bot = false # 是否屏蔽QQ官方机器人
enable_poke = true # 是否启用戳一戳功能

NapCat 部署

推荐使用 NapCat.Win.一键版本

编辑 napcat.quick.bat,将 .\NapCatWinBootMain.exe 后面的数字改成需要 AI 登录的 QQ 号,这样只需登录一次,以后都可以快速登录。

配置 MaiBot 和 Adapter

如果只是想将项目跑起来,等到后面的图形化界面,通过那里修改配置即可。

Api 获取: 硅基流动 SiliconFlow - 致力于成为全球领先的 AI 能力提供商

MaiBot NapCat adapter 配置

Ctrl+左键 点击 Url 进入 WebUi 面版

URL位置

点击 网络配置->新建->Websocket客户端, 按文档配置

理论上按照默认 config.toml.env ,不用修改任何配置,可以正常运行。(除非作者更新了)

运行

按照文档输入指令,启动服务。

MaiBot\.env 文件获取 WebUI 的地址和端口

# WebUI 服务器默认配置
WEBUI_HOST=127.0.0.1
WEBUI_PORT=8001

进入 MaiBot Dashboard (也就是 127.0.0.1:8001/),在运行 MaiBot 的命令行复制提供给你的 Token 进行登录

Token位置

如果在初始引导没有配置 api,可以点击 AI模型厂商配置,编辑 SiliconFlow

登录硅基流动 SiliconFlow - 致力于成为全球领先的 AI 能力提供商,在 API密钥 中点击 新建API密钥 ,将新建的密钥复制粘贴到 API Key

AI模型厂商配置

点击”小闪电”测试连接,状态正常即可。