大佬轻喷
一、简介(截自GitHub页面)NoneBot2 是一个现代、跨平台、可扩展的 Python 聊天机器人框架,它基于 Python 的类型注解和异步特性,能够为你的需求实现提供便捷灵活的支持。本教程将针对啥都不会的小白,提供几种方法用于快速部署QQ机器人(NoneBot2+go-cqhttp)。
NoneBot2 项目GitHub源地址: https://github.com/nonebot/nonebot2
NoneBot2 项目官方网址: https://v2.nonebot.dev
go-cqhttp 官方文档地址: https://docs.go-cqhttp.org
二、目录python环境配置
IDE配置
ffmpeg配置
go-cqhttp配置
如何创建并运行一个bot项目
安装更多的插件,获得更多的功能bug
三、环境配置Python环境配置
首先先前往Python的官网下载Python(这里我使用的是3.10.9版本)
网址: https://www.python.org/dowlands/
网不好的同学请科学上网
点击那个框选住的Download就可以进入选择下载文件的页面啦然后找到Files,这里我选择的是64位
点击这个就可以下载啦然后打开我们刚才下载好的文件
我觉得这个应该没人不会吧然后进行安装操作(记得底下两个全部勾选)
跟图一样就不会错了(确信)
然后win(就是唤起开始菜单的键) + R打开运行,输入cmd打开cmd界面,如果出现和下图一样的的情况就说明成功了
>>>就表示进入python环境了IDE配置
按理来说这部分可以完全不需要的因为如果只是简单的部署机器人并安装插件完全可以通过Powershell(cmd) + 用记事本修改完成
我个人比较推荐使用Pycharm或者VSCode
(但是由于Pycharm可以快速创建避免出事的虚拟环境并且代码补全很强大所以个人推荐)
使用Pycharm
Pycharm下载网址: https://www.jetbrains.com/pycharm/download/#section=windows
下载社区版就够用了,如果你有学校邮箱也可以尝试申请专业版白嫖
安装路径方面.......随便选一个你自己喜欢的位置就行
这些选项......随意,可以不勾选
之后一直点就行知道开始安装就行,pycharm会自动装好
使用VSCode
VSCode下载网址: https://code.visualstudio.com/
之后将下载的安装包打开即可,安装步骤与pycharm基本相同,这里就不过多赘述,之后打开vscode,安装python插件和pylance(其他的插件根据需要)
ffmpeg配置
这个部分主要负责让你的机器人可以发出语音,不过配置相对较麻烦一点
下载地址: https://github.com/BtbN/FFmpeg-Builds/releases
点击这个就会自动开始下载然后把文件夹解压到你想放的位置(这里我放在c盘的Program Files)
然后利用系统的搜索搜索“环境变量”就可以找到这个,然后点击“编辑账户的环境变量”
之后弹出来的窗口再点击“环境变量”,即可对环境变量进行操作
接着选中(点击即可)用户变量里的Path然后点编辑在新建一个环境变量
然后找到你刚才安置ffmpeg的地方,打开ffmpeg文件夹,找到bin这个文件夹打开,然后复制路径粘贴进新建的环境变量即可
接着一路确定保存环境变量,然后依旧是刚才的方法打开cmd,输入“ffmpeg –version”如果显示下图的结果就是大功告成啦
go-cqhttp配置
go-cqhttp下载地址: https://github.com/Mrs4s/go-cqhttp/releases
点击这个下载即可
之后把下载的exe文件放到你想放的位置(最好和你的bot项目一起,方便管理),双击启动,然后就会弹出这个,直接点确定就好了
然后目录里就会多出一个文件,然后双击这个多出来的文件,对于我们的快速部署反向ws就足够了,输入3然后回车即可
显示这个后,就可以关掉这个页面了
然后用vscode打开刚才那个文件(pycharm也行,不过打开pycharm很慢)
其实记事本改也行不过不是很友好
然后将qq账号那一栏的123456改为机器人的qq号(不填也行自动扫码登录),再往下滑到底找到连接服务器列表,将universal那一栏改成同展示的一样,当然那个11451可以换成1~65535任何一个数字,不过个人建议五位数端口号,防止被占用
之后再打开刚才的批处理文件,就会弹出二维码让我们扫描了(当然也存在其他验证方式,但需填写qq号及密码),当然,如果是云服务器部署的话,需要将本地登录生成的文件上传上去即可
之后再打开这个批处理文件就是这样了
之后你会发现虽然能接收到消息了但是还有黄色的警告,这是通常因为还没有连上nonebot2框架的原因(也有可能是端口占用,换个端口就行),不过就目前而言go-cqhttp也搞定了
四、创建第一个机器人项目搭建虚拟环境
由于我们可能会有各种各样的python项目,而每个项目所需要的相同库的版本可能不同,如果混在一起就容易发生事故,所以我们依靠虚拟环境使我们的项目独立在一个小环境中,不受干扰,以下提供几种方法
使用nb-cli自动配置虚拟环境(推荐)
依旧是win + R然后输入cmd(不过这里更推荐powershell,功能更强大)
这里需要切换一下我们的工作路径,因为我们要在bot项目文件夹创建bot而不是别的位 置,输入cd 切换
如果是win11背景是黑色的这样就是成功切换了
之后安装nb-cli,接着输入这个回车即可(如果运行过程中报错通常是网络问题)
如果因为网络原因多次报错,可以输入这个
最后这样就安装好了(读条可能不一样很正常)
然后输入nb并回车启动nb-cli
出现这个就表明成功了然后上下选择,选第一个创建项目并回车,并继续回车选择初学者或用户
然后给自己的项目命名
这个界面依旧是回车
这个界面一定要注意了,用空格或者鼠标选中
然后选中第一个,并回车
之后填y并回车
创建虚拟环境也填y并回车
出现这个就代表完成了
之后每次启动bot只需要按以下步骤输入即可
使用pycharm创建
首先需要新建一个项目
只需要将第一栏项目位置改到你希望的地方即可,其他可以不动
然后就会自动创建好虚拟环境
之后点击终端(即框选的这个)即可自动启动虚拟环境
之后机器人项目的创建同前种方法相同,唯一的区别在创建虚拟环境填n
nonebot2框架配置
打开env.prod文件添加以下内容
这里因为我之前填的的是11451所以需要相同,管理员账号填自己QQ号即可
图片中的SURPERUSER漏了一个S应为SURPERUSERS(大佬别骂了呜呜呜)运行
按照先前的指令启动nonebot2框架同时运行gocq(那个批处理文件)当出现如图情形:nonebot框架显示connection open go-cqhttp显示连接到反向ws服务器时即可正常运作
五、安装插件nonebot2有丰富的社区生态,可以在插件商店中获取你想要的插件,接下来将简单介绍如何安装插件
nonebot2商店网址: https://v2.nonebot.dev/store
以离线文档为例,只需要点击复制安装命令,然后按照之前运行机器人的指令开启虚拟环境即可安装
截自商店页面同时,部分插件需填写配置项,课点击插件右上角的GitHub图标进入GitHub查看,如官方服务器状态插件
这个官方插件就需要在env.prod里配置消息模板六、其他Nonebot常见问题汇总: https://github.com/nonebot/discussions/discussions/13