NoneBot+Lagrange搭建qq机器人保姆级别教程

前言

因为一些原因，go-cqhttp不一定能使用，gocq的作者也是呼吁大家尽快转移到无头NTQQ项目当中去，其中就有很多优秀的平替作品，如:NapNeko/NapCatQQ: 基于NTQQ的无头Bot框架 (github.com)还有今天要介绍的LagrangeDev/Lagrange.Core: An Implementation of NTQQ Protocol, with Pure C#, Derived from Konata.Core (github.com)

准备工作

1. 一台电脑或服务器(服务器搭建bot的教程后面会出)
2. Lagrange程序
3. python3.9及以上版本
4. nonebot插件

1.关于操作系统

可供选择的操作系统:

1. Windows
2. Linux
3. MacOS

2.Lagrange程序下载

首先是程序下载链接：Releases · LagrangeDev/Lagrange.Core (github.com)

根据操作系统不同选择不同的版本

1.Windows

根据系统架构选择版本，我的是64位操作系统就选择我圈起来的

解压压缩包，获得程序本体，将程序本体移动到项目文件夹，这里我移动到Bot2文件夹，双击运行程序出现下面的界面

使用要做bot账号的qq扫描二维码，成功扫描后会在程序同级目录下生成诸多文件

此时我们需要修改 appsettings.json 配置文件，粘贴以下内容进配置文件

{"Logging":{"LogLevel":{"Default":"Information","Microsoft":"Warning","Microsoft.Hosting.Lifetime":"Information"}},"SignServerUrl":"https://sign.lagrangecore.org/api/sign/25765","MusicSignServerUrl":"","Account":{"Uin":0,"Password":"","Protocol":"Linux","AutoReconnect":true,"GetOptimumServer":true},"Message":{"IgnoreSelf":true,"StringPost":false},"QrCode":{"ConsoleCompatibilityMode":false},"Implementations":[{"Type":"ReverseWebSocket","Host":"127.0.0.1","Port":8080,"Suffix":"/onebot/v11/ws","ReconnectInterval":5000,"HeartBeatInterval":5000,"AccessToken":""}]}

修改完成后重新启动程序，至此Lagrange的安装以及配置已经完成

2.Linux/MacOS

同样的选择对应系统架构的版本

获得压缩包后将压缩包放到项目文件夹中使用 tar -xvf 压缩包名称 命令来解压压缩包，与window相同，将解压出来的可执行文件放到项目根目录（MacOS同理）

获得可执行文件后先给程序赋予权限(可选，推荐进行这一步)

chmod +x ./Lagrange.OneBot 

赋予权限后运行程序

./Lagrange.OneBot 

剩下的步骤和windows一致扫描二维码以及修改配置文件，这里不过多赘述

2.NoneBot框架搭建

1.安装官方手脚架

注意: python版本要大于或等于3.9，nonebot仅支持3.9及以上版本

Windows和Linux一样，都打开命令行(Windows是cmd)输入以下命令

pip install nb-cli 

安装完成后输入 pip list 查看列表中是否有nb-cli

2.使用手脚架创建项目

确认手脚架安装完毕我们开始创建项目

输入以下命令

nb create 

我个人比较习惯simple模板因为旧版nonebot就是simple模板，这里按照个人喜好进行选择，用键盘上下键选择，选择完毕后回车

这里需要输入项目名称，大家随便取，这里我就取名test，取好名字就回车

这里让我们选择适配器，我们选择OneBotV11使用方向键选择，空格确定然后回车

这里选择驱动器，默认选择了fastapi直接回车就行

这里选择插件存储位置，选择src然后回车

是否安装依赖，填y回车

是否创建虚拟环境，我这里有虚拟环境所以填n，有小伙伴可能不知道虚拟环境是什么，可以去百度一下，反正就是为了让项目依赖不混乱的

要使用哪些内置插件，可以不选择直接回车

如果安装顺利你会看到以下界面

根据提示的命令我们运行框架，如果前面的步骤进行顺利会看到以下界面，connection open 代表框架已经和Lagrange握手链接，至此我们的qqbot已经搭建完成

3.测试Bot是否正常

如果想要测试bot是否启动正常可以在 src/plugins 目录下新建 test.py 文件写入以下内容

''' Author: 萌新源 Date: 2024-08-07 18:14:19 LastEditTime: 2024-08-08 23:15:31 LastEditors: 萌新源 Description: 测试bot是否正常启动 个性签名：敲代码就仨字，我乐意 '''from nonebot import on_regex from nonebot.typing import T_State from nonebot.adapters.onebot.v11 import GroupMessageEvent, Bot, Message Test = on_regex(pattern=r'^测试$',priority=1)@Test.handle()asyncdefTest_send(bot: Bot, event: GroupMessageEvent, state: T_State): msg ="Bot启动正常"await Test.finish(message=Message(msg))

在bot所在群聊发送测试如果看到bot回复Bot启动正常那么恭喜你你成功搭建了一个qq机器人

结尾

qq交流群：934541995

好了，至此你已经学会如何搭建一个属于自己的qq机器人了，如果本文章有帮助到你可以给我一个一键三连吗，谢谢

后续我也会考虑写nonebot插件开发教程，具体看呼声大不大了

最后感谢您的耐心阅读，我们下期再见