NoneBot 与 Lagrange 搭建 QQ 机器人教程

前言

由于 go-cqhttp 可能无法使用，建议转移到无头 NTQQ 项目。其中 Lagrange 是一个优秀的平替作品。

准备工作

1. 一台电脑或服务器
2. Lagrange 程序
3. Python 3.9 及以上版本
4. NoneBot 插件

1. 关于操作系统

支持 Windows、Linux、MacOS。

2. Lagrange 程序下载

前往 GitHub Releases 页面下载对应系统架构的版本。

1. Windows

解压压缩包，将程序本体移动到项目文件夹。双击运行程序，使用 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":""}]}

修改完成后重新启动程序。

2. Linux/MacOS

解压压缩包至项目根目录。赋予执行权限：

chmod +x ./Lagrange.OneBot 

运行程序：

./Lagrange.OneBot 

后续步骤与 Windows 一致，扫描二维码并修改配置文件。

3. NoneBot 框架搭建

1. 安装官方脚手架

确保 Python 版本 >= 3.9。在命令行输入：

pip install nb-cli 

安装完成后输入 pip list 确认 nb-cli 存在。

2. 创建项目

输入以下命令创建项目：

nb create 

按提示选择模板（如 simple）、项目名称、适配器（OneBotV11）、驱动器（fastapi）、插件存储位置（src）。依赖安装选 Y，虚拟环境视情况选择。

安装顺利后，根据提示运行框架。若连接成功，会显示 connection open，代表框架已与 Lagrange 握手。

3. 测试 Bot 是否正常

在 src/plugins 目录下新建 test.py 文件，写入以下内容：

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()
async def test_send(bot: Bot, event: GroupMessageEvent, state: T_State):
    msg = "Bot 启动正常"
    await Test.finish(message=Message(msg))

在 Bot 所在群聊发送'测试'，若收到回复则搭建成功。