跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

NoneBot 与 Lagrange 搭建 QQ 机器人教程

综述由AI生成详细讲解了如何使用 Lagrange 框架结合 NoneBot 搭建 QQ 机器人的完整流程。首先准备电脑及 Python 环境,下载并配置 Lagrange 程序以连接 NTQQ 协议。随后安装 NoneBot CLI 脚手架,创建基于 OneBot V11 适配器与 FastAPI 驱动的项目。最后通过编写简单的正则测试插件验证机器人是否正常运行。支持 Windows、Linux 及 MacOS 系统部署。

信号故障发布于 2026/4/6更新于 2026/5/2328 浏览
NoneBot 与 Lagrange 搭建 QQ 机器人教程

前言

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

文章配图

准备工作

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

1.关于操作系统

可供选择的操作系统:

  1. Windows
  2. Linux
  3. MacOS

2.Lagrange 程序下载

首先是程序下载链接:Releases · LagrangeDev/Lagrange.Core

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

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 文件写入以下内容

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

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

文章配图

目录

  1. 前言
  2. 准备工作
  3. 1.关于操作系统
  4. 2.Lagrange 程序下载
  5. 1.Windows
  6. 2.Linux/MacOS
  7. 2.NoneBot 框架搭建
  8. 1.安装官方脚手架
  9. 2.使用脚手架创建项目
  10. 3.测试 Bot 是否正常
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 从手动标注到智能打标:AI 数据标注工具实战解析
  • Ubuntu 26.04 LTS 新特性前瞻:GNOME 50、GCC 15 与全栈升级
  • 数据结构:带头双向循环链表详解与实现
  • WorkBuddy 接入 QQ 机器人配置指南
  • DeerFlow 2.0 开源:字节跳动超级智能体框架技术解析
  • 数据结构:栈与队列的定义、核心操作与代码解析
  • SpringBoot3 整合 Swagger3 解决 HttpServletRequest 类型缺失错误
  • 嵌入式 Linux 实战:基于泰山派的 AI 网络摄像头
  • Python 包管理工具 uv 全面指南:安装、命令与性能优化
  • GR-RL:基于离线 RL 与在线微调的机器人系鞋带 VLA 策略
  • LlamaFactory 大模型微调实战与参数详解
  • 三大扩散模型性能对比:Z-Image-Turbo、ComfyUI 与 Stable Diffusion
  • Microsoft Visual C++ Runtime 下载指南
  • Midjourney 进阶:色相详解与色彩控制
  • 银发族 AI 助手:AIGC 陪聊防骗与离线部署实践
  • YOLOv8 旋转框角度回归优化:CSL 与 DCL 编码实战
  • OpenClaw 多 Agent 与多飞书机器人配置指南
  • AIGC 中的变分自编码器(VAE)原理与 PyTorch 实现
  • webdav-server 轻量级 WebDAV 服务器部署与配置指南
  • eBay 商品数据采集实战:基于网页抓取 API 的 Python 接入方案

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online