NoneBot + Lagrange 搭建 QQ 机器人实战指南

保存并重启程序，确认能正常连接即可。至此，Lagrange 的基础安装与配置已完成。

Linux / MacOS 用户

同样选择对应架构的版本。解压后，将可执行文件放入项目根目录。如果是 Linux 系统，建议先赋予执行权限：

chmod +x ./Lagrange.OneBot

然后运行程序：

./Lagrange.OneBot

后续步骤与 Windows 一致，扫码并修改配置文件即可，不再赘述。

搭建 NoneBot 框架

安装脚手架

注意： NoneBot 仅支持 Python 3.9 及以上版本。

在命令行（Windows 下为 cmd）中执行以下命令安装 nb-cli：

pip install nb-cli

安装完成后，可以通过 pip list 检查列表中是否包含 nb-cli。

创建项目

确认脚手架安装完毕，开始初始化项目：

nb create

按照提示进行操作。模板建议选择 simple，这是最经典的模板结构。输入项目名称，例如 test。

接下来选择适配器，这里我们选用 OneBotV11。驱动器默认选择 fastapi 即可。插件存储位置建议选择 src。

对于依赖安装和虚拟环境，根据你的实际环境选择 y 或 n。如果不确定虚拟环境的作用，可以理解为它是隔离项目依赖的一种方式，避免污染全局环境。

内置插件暂时可以不选，直接回车跳过。

顺利的话，你会看到项目创建成功的提示。根据控制台指示运行框架，如果前面的步骤无误，你应该能看到 connection open 字样，这代表 NoneBot 已经成功与 Lagrange 握手连接，QQ 机器人核心环境已就绪。

测试 Bot 状态

为了验证 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 所在的群聊发送'测试'指令，如果 Bot 回复了'Bot 启动正常'，恭喜你，一个属于自己的 QQ 机器人已经搭建完成了。

结语

到这里，你已经掌握了基于 NoneBot 和 Lagrange 搭建 QQ 机器人的基本流程。后续如果有兴趣，可以尝试编写更复杂的插件功能。感谢阅读，祝开发顺利。