准备工作
约 1887 字大约 6 分钟
2025-03-13
一:安装Python环境
下载安装包

单机黄色按钮下载安装包
安装过程

✅ 必须勾选 Add Python.exe to PATH
🔘 选择 Install Now
完成安装
二:部署MongoDB数据库
获取安装包
MongoDB官方下载 推荐使用IDM等下载工具加速

MongoDB 的版本偶数版本为稳定版,奇数版本为开发版。
MongoDB 对于32位系统的支持不佳,所以3.2版本之后就没有对32位系统的支持。
MongoDB for Windows 64-bit 适合 64 位的 Windows Server 2008 R2, Windows 7 , 及最新版本的 Window 系统。
MongoDB for Windows 64-bit Legacy 适合 64 位的 Windows Vista, Windows Server 2003, 及 Windows Server 2008 。
MongoDB for Windows 32-bit 适合 32 位的 Window 系统及最新的 Windows Vista。 32 位系统上 MongoDB 的数据库最大为 2GB。
下载 .msi 文件,下载后双击该文件,按操作提示安装即可。
安装过程
双击打开安装包:
出现协议窗口,选中同意选项,点击 "Next" 按钮:
出现两个选项:
Complete
完整安装 默认配置安装所有 MongoDB 组件和工具,当然你也可以选择自定义安装。Custom
自定义安装
一般选择完整安装即可
点击展开
自定义安装会多出如下选项,你可以自定义MongoDB本体安装路径以及可选组件
现在,出现了两个选择:
从MongoDB 4.0开始,您可以在安装期间配置和启动MongoDB作为服务,并在成功安装后启动MongoDB服务
Run Service as Network Service user:以网络服务用户身份运行服务(默认)
这是Windows内置的Windows用户账户
Run Services as a local or domain user:以本地或域用户身份运行服务对于现有本地用户账户
Domain填"."(小数点)即可
Account Name为当前Windows用户名
Account Password为Windows用户密码 (注意不是PIN密码)
对于现有的本地用户帐户,请指定一个句点作为帐户域(即.),并为该用户指定帐户名称和帐户密码。
对于现有域用户,请为该用户指定“ 帐户域”,“帐户名”和“ 帐户密码 ”
如果您只需简单操作和基本功能,默认的网络服务用户选项即可如果您需要对权限进行更多控制,或者需要使用特定用户凭据访问和限制资源,则选择本地或域用户选项会更合适
Service Name:指定服务名称,默认名称是MongoDB。如果您已拥有具有指定名称的服务,则必须选择另一个名称
Data Directory:指定数据目录,对应于–dbpath。如果该目录不存在,安装程序将创建该目录并设置对服务用户的目录访问权限
Log Directory:指定日志目录,该目录对应于–logpath。如果该目录不存在,安装程序将创建该目录并设置对服务用户的目录访问权限
只安装MongoDB(不推荐)
这里我们可以直接next
:
Install MongoDB Compass:
安装MongoDB的GUI软件,因为网络的原因,某些地区可能下载很慢,如果您遇到这种情况,请尝试去掉勾选,可在安装完成之后另外下载安装。
至此,MongoDB安装完成了✅ 安装完毕之后,默认会自动运行数据库服务。浏览器打开 此链接 出现以下文字表明数据库正在运行!
It looks like you are trying to access MongoDB over HTTP on the native driver port.
您可以通过修改MongoDB的bin
目录下的mongod.cfg
来修改服务运行配置
启动 MongoDB 服务
net start MongoDB
关闭 MongoDB 服务
net stop MongoDB
移除 MongoDB 服务
mongod --remove
添加环境变量 (还是指令大佬)
如果您不想用MongoDB Compass对数据库进行管理,也不想使用MongoDB自带的shell工具,而是想在Windows CMD/PowerShell中执行命令,那您还需要多一步添加环境变量:
只需摁住Win+R打开运行窗口输入:
setx path "%path%;MongoDB的bin路径" /M
例如我的MongoDB的bin
路径为C:\Program Files\MongoDB\Server\8.0\bin
,那么我只需要输入
setx path "%path%;C:\Program Files\MongoDB\Server\8.0\bin" /M
注意
只能用运行窗口或CMD运行该命令
严禁使用PowerShell运行该命令
严格按照要求输入命令
打错出事别来找我
三:配置NapCatQQ框架
下载安装
NapCatQQ最新版
选择 Win64无头版本(网盘链接)
或NapCat.Shell(GitHub发行直链)
在你喜欢的地方新建一个文件夹命名为NapCat.Shell,将下载下来的压缩包解压到此处
NapCat,启动!
强迫症必须重命名
quickLoginExample.bat
为quickLogin.bat
,接着右键编辑,带有
REM
的为注释 删掉你需要的系统的那行命令开头REM这三个单词,并把123456
修改为你需要自动登录的Bot的QQ号保存(Ctr+S)退出并运行该脚本即可启动NapCat.Shell
如图,在启动后会出现一行
[NapCat] [WebUi] WebUi Local Panel Url: http://127.0.0.1:端口号/webui?token=密码
摁住Ctrl键并单击链接即可跳转到浏览器打开NapCat的WebUI
按照提示进行登录后即可进入管理界面
配置WebSocket客户端
此时点击左侧边栏的
网络配置
菜单:鼠标移到
新建
选项上,点击Websocket
客户端
随后在弹出的窗口
单击启用
名称
起一个你想要的名字,比如我填的是MaiMBOT
URL
填入 ws://127.0.0.1:8080/onebot/v11/ws
消息格式
选择 String
字符串格式
其余保持默认即可,点击保存
恭喜你配置完了NapCatShell🥳
四:获取MaiMBot主体
如果无法访问到Github请尝试使用dev-sidecar,软件使用教程
GitHub获取
访问项目仓库,切换到debug分支下

接着点击绿色的Code
按钮,点击Downlod ZIP
下载压缩包

将压缩包解压到你喜欢的地方
五:申请API密钥
SiliconCloud
注册 (包含我的邀请链接,注册赠送14元余额) 注册入口
创建密钥
点击右上角
新建API秘钥
生成密钥,弹出的窗口直接点击新建密钥
,描述可以不填,创建完成后单击密钥文本即可复制下来
六:项目环境配置
打开终端
打开你之前从GitHub上下载并解压缩的MaiMBot-debug文件夹,找一处空白的地方,右键在终端中打开(T)
创建虚拟环境 (如果你不知道虚拟环境是什么,那请 跳过此步骤)
python -m venv bot
bot\Scripts\activate
配置清华镜像源
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
pip install -r requirements.txt
初始化项目
在shell/cmd输入以下命令后再关闭
nb run
📎 资源汇总
Python官网 |
---|
(Steam++)Watt Toolkit官网 |
NapCatQQ仓库 |
MaiMBot仓库 |
MongoDB下载 |