2024 年最新基于 LLOneBot NT 框架搭建 QQ 机器人详细教程（更新中）

已于 2024-08-14 22:58:37 修改
阅读量1.8w 收藏 76
点赞数 25
分类专栏： QQ机器人详细制作教程 文章标签： 机器人 python
于 2024-06-14 23:48:57 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_47452807/article/details/139640167
版权

LLOneBot 概述

llonebot（LLOneBot）是一个与OneBot（也称为CQHTTP）协议兼容的机器人框架，它允许开发者使用不同的编程语言（如Python、Go、JavaScript等）编写机器人应用，并与各种支持 OneBot 协议的聊天平台（如QQ、Telegram、Discord等）进行交互。

LLOneBot 官方网站：https://llonebot.github.io/zh-CN/

在这里插入图片描述

附加：Onebot 11 框架概述

onebot 11 背景

CQHTTP 插件是 2017 年初出现的基于 CKYU 机器人平台的一款开源免费插件，它使用户能够通过 HTTP 或 WebSocket 对 CKYU 的事件进行上报以及接收请求来调用 CKYU 的 DLL 接口，从而可以使用其它语言（不方便编译到原生二进制的语言）编写 CKYU 插件。

有非常多的开发者使用 Python、Java、Node.js 等 web 开发常用语言基于 CQHTTP 插件编写各式各样的聊天机器人。在新的机器人平台 Mirai 开始发展之后，以及 CKYU 决定停运之后，为了让原来基于 CQHTTP 插件编写的机器人能够继续运行，一些开发者在其它机器人平台上编写了兼容 CQHTTP 接口的插件/模块。

onebot 11 动机

基于 CQHTTP 插件编写的机器人项目有很多，CKYU 停运后，如果不能平滑迁移到其它平台，这些项目的很多代码都需要重写，甚至有很多项目可能被迫放弃维护，这对机器人开发社区来说是一种损失和浪费。

目前各 CQHTTP 兼容项目通常是实现了部分原 CQHTTP 插件的接口，并利用新平台的特性，新增了一些拓展接口。长远来看，这可能导致不同兼容项目最终形成了各自的「CQHTTP 接口变种」，当用户深度接入其中一个兼容项目后，可能又会出现与其它变种不兼容的情况，最终仍然存在潜在的迁移困难。

本项目希望通过改写原 CQHTTP 插件文档 + 引入 CQHTTP 兼容项目的新特性的方式，维护一个统一的、不断发展的接口标准（即 OneBot 标准），推动各 CQHTTP 兼容项目实现长远的兼容，为用户带来便利。

安装 QQNT 架构 QQ

QQNT是腾讯QQ最新采用的一种技术架构，这一架构在2023年得到了全面的应用和推广。它代表了QQ技术架构的一次重大升级，旨在提升QQ的整体性能、流畅度和稳定性。

跨平台内核层：QQNT架构采用C++开发了跨平台内核层，将IM核心业务逻辑、QQ通用组件，以及线程、网络、IO等通用资源管理模块和操作系统封装部分统一下沉到这一层。

模块解耦：新架构按业务划分模块，业务模块之间相互解耦，通过接口和路由进行通信。同时按层级设计划分，层级自上而下依赖，上层模块可依赖下层模块，但下层模块不能逆向依赖上层模块。

性能优化：基于全新数据流架构、数据预加载和UI逻辑并行化的设计思路，完成单向数据流驱动与异步加载渲染，系统资源全力供给关键功能，如聊天窗口（AIO），最终性能指标提升明显。

安装包下载地址：https://im.qq.com/pcqq/index.shtml

在这里插入图片描述

立即安装 QQ

在这里插入图片描述

llob_install.exe 安装

快速开始

QQ 版本 LLOneBot 支持到最新版本的 QQ。不推荐太老的版本，9.9.7(21804) 之前的版本都没有经过仔细测试，可能会有一些问题。

Windows 用户一键安装方案

install_llob 下载地址：https://github.com/super1207/install_llob/releases

在这里插入图片描述

下载 install_llob.exe 安装可执行文件。双击运行 install_llob.exe 即可开始自动安装。

常见报错

2024-06-14 22:43:51  INFO llob_install: 欢迎使用LLOB安装器0.0.4 by super1207
2024-06-14 22:43:51  INFO llob_install: 正在检查是否拥有管理员权限...
2024-06-14 22:43:51  INFO llob_install: 拥有管理员权限
2024-06-14 22:43:51  INFO llob_install: 正在查询QQ安装位置...
2024-06-14 22:43:51  INFO llob_install: 从注册表获取到QQ.exe
2024-06-14 22:43:51  INFO llob_install: QQ安装位置: "C:\\Program Files\\Tencent\\QQNT"
2024-06-14 22:43:51  INFO llob_install: 正在检查QQ是否正在运行...
2024-06-14 22:43:53 ERROR llob_install: QQ正在运行，请先结束QQ

注意：安装时候请关闭 QQ 进行 install_llob.exe 执行安装。

安装演示

在这里插入图片描述

登陆 QQ 查看设置

在这里插入图片描述
打开 QQ 的设置，看到了 LLOneBot 就代表安装成功了。

在这里插入图片描述

通用安装教程：https://llonebot.github.io/zh-CN/guide/getting-started

LiteLoaderQQNT 插件加载器

llob_install.exe 安装完成，打开 QQ 设置发现存在 LiteLoaderQQNT、LLOneobt v.x.x.x。其中 LiteLoaderQQNT 是 QQNT 的插件加载器，一般在 QQNT 的环境内简称为 LiteLoader。它可以让你自由地为 QQNT 添加各种插件，并实现例如美化主题、增加功能等各种功能。

LiteLoaderQQNT 插件加载器官网：https://liteloaderqqnt.github.io/

在这里插入图片描述

开发插件文档教程：https://liteloaderqqnt.github.io/docs/introduction.html

安装 NoneBot 框架

环境需求：Python 版本 >= 3.8

配置镜像源

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

升级 pip 包管理器

pip install --upgrade pip

安装 nb-cli 脚手架

pip install nb-cli -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，你可以在命令行使用 nb 命令来使用脚手架。如果出现无法找到命令的情况（例如出现“Command not found”字样)，重启一下命令行窗口。

package 安装（可忽略：nb-cli 自动安装所需依赖包）

nb-cli 脚手架

pip install nb-cli -i http://mirrors.aliyun.com/pypi/simple/ requests --trusted-host mirrors.aliyun.com

nonebot2 框架

pip install nonebot2 -i http://mirrors.aliyun.com/pypi/simple/ requests --trusted-host mirrors.aliyun.com

nonebot-adapters-onebot 适配器

pip install nonebot-adapter-onebot  -i http://mirrors.aliyun.com/pypi/simple/ requests --trusted-host mirrors.aliyun.com

fastapi

pip install nonebot2[fastapi] -i http://mirrors.aliyun.com/pypi/simple/ requests --trusted-host mirrors.aliyun.com

配置连接 NoneBot2 框架

配置对接其他框架：例如 Koishi、NoneBot

在这里插入图片描述

提示：Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架。

补充：Koishi 官方网站：https://koishi.chat/zh-CN/

配置 NoneBot

这里假设你已经安装了 Onebot 适配器，默认情况 NoneBot 是启用了反向 ws 的，可能是默认配置问题，需要配置 token 才能正常连接，修改 NoneBot 配置文件 .env，添加 ONEBOT_ACCESS_TOKEN=你的token。然后启用 NoneBot，可以看到 NoneBot 输出的端口号，如 8080 端口。

ONEBOT_ACCESS_TOKEN=你的token

配置演示截图

在这里插入图片描述

在 LLOneBot 配置页面添加反向 ws 地址，地址为 ws://127.0.0.1:8080/onebot/v11/ws, 这里的 8080 是 NoneBot 输出的端口号，/onebot/v11/ws 是 NoneBot onebot 适配器默认的路径。

注意：记得 LLOneBot 配置的 token 需要和 NoneBot 配置的 一致

创建启动 NoneBot2 项目

nb create

选择 bootstrap 初学者或用户

在这里插入图片描述
填写项目名称选择适配器
在这里插入图片描述
驱动器选择 FastAPI 驱动器

在这里插入图片描述

选择内置插件 例如：选择 echo

使用 poetry 或 pdm 等依赖管理工具添加以下包:
  nonebot-adapter-onebot nonebot2[fastapi]
运行以下命令来启动你的机器人:
  cd linenazi-bot
  nb run --reload

在项目文件夹中创建一个 .env 文本文件

HOST=0.0.0.0  			# 配置 NoneBot 监听的 IP / 主机名
PORT=8080  				# 配置 NoneBot 监听的端口
COMMAND_START=["/"]  	# 配置命令起始字符
COMMAND_SEP=["."]  		# 配置命令分割字符

启动 Bot

nb run --reload

06-14 23:38:49 [SUCCESS] nonebot | NoneBot is initializing...
06-14 23:38:49 [INFO] nonebot | Current Env: prod
06-14 23:38:49 [SUCCESS] nonebot | Succeeded to load plugin "echo" from "nonebot.plugins.echo"
06-14 23:38:49 [SUCCESS] nonebot | Running NoneBot...
06-14 23:38:50 [INFO] uvicorn | Started server process [7580]
06-14 23:38:50 [INFO] uvicorn | Waiting for application startup.
06-14 23:38:50 [INFO] uvicorn | Application startup complete.
06-14 23:38:50 [INFO] uvicorn | Uvicorn running on http://127.0.0.1:8080 (Press CTRL+C to quit)
06-14 23:38:51 [INFO] uvicorn | ('127.0.0.1', 50817) - "WebSocket /onebot/v11/ws" [accepted]
06-14 23:38:51 [INFO] nonebot | OneBot V11 | Bot 你的QQ号 connected
06-14 23:38:51 [INFO] websockets | connection open

出现 connection open 说明启动成功，成功连接 LLonebot 端。

补充更新：插件加载器安装

若 llob_install.exe 安装失败则进行采用手动安装 LiteLoaderQQNT 插件加载器

安装文档：https://liteloaderqqnt.github.io/guide/install.html

下载 LiteLoaderQQNT：使用 Git 工具将 LiteLoaderQQNT 仓库 Clone 到本地任意位置

git clone --depth 1 https://github.com/LiteLoaderQQNT/LiteLoaderQQNT.git

在这里插入图片描述
配置 resources\app\app_launcher\index.js

找到 QQNT 安装目录编辑 resources\app\app_launcher\index.js 文件

require(String.raw`C:\LiteloaderQQNT`); // 此处换成你 LiteLoaderQQNT 目录位置
require('./launcher.node').load('external_index', module);

在这里插入图片描述

DLLHijackMethod

由于 Windows 系统平台 QQNT 被添加文件完整性验证，你需要额外步骤来解除限制。在 Release 下载 dll 文件，重命名 dbghelp.dll 放入 QQ.exe 同级目录下即可。

DLLHijackMethod dbghelp.dll 下载地址：https://github.com/LiteLoaderQQNT/QQNTFileVerifyPatch/tree/DLLHijackMethod

在这里插入图片描述

设置 plugins 目录

在这里插入图片描述
LiteLoaderQQNT 目录创建 plugins 目录

在这里插入图片描述
运行 QQ 安装成功

在这里插入图片描述

NoneBot2 常见案例

待更新······

Python聊天机器人-NoneBot2入门（2024新版）
⚡
08-16 7013
NoneBot2 + Napcat 配置
2024 QQ机器人可用框架汇总【10月更新】
Anshebg_的博客
09-29 6725
Mirai QQ Android 协议支持库与高效率的机器人框架 纯 Kotlin 实现协议和支持库 mirai 既可以作为项目中的 QQ 协议支持库, 也可以作为单独的应用程序与插件承载 QQ 机器人服务。梦幻框架、梦幻机器人、Drea Robot、QQ机器人、DoDo机器人，本框架高效稳定，支持多协议，多账号，多平台，并且完全免费。Kitty框架：【免费】 RemixQQ：【免费】大栗子框架【免费】小芒果框架【免费】白泽框架【免费】 少萝框架【免费】三玖框架【免费】 梦幻框架【免费】
Android 手机QQ聊天记录导出（NTQQ），解密聊天数据库
最新发布
butterfly_new的博客
03-20 1829
本教程导出的聊天记录QQ版本的NT版本的，即QQ8.9之后的版本，我的QQ版本是9.1.50.23520，QQ8.9之后的版本为NT架构，如果是之前的版本，建议查看另一个大佬的项目：[地址]
超详细教程：用Python制作QQ机器人！
Python_trys的博客
03-01 1524
通过本教程，你已经学会了如何使用Python和NoneBot2框架制作一个简单的QQ机器人。你可以根据需要扩展机器人的功能，例如添加定时任务、群管理功能等。希望本文对你有所帮助，祝你在开发QQ机器人的过程中取得成功！QQ机器人是一种自动化工具，可以用于群管理、自动回复、消息推送等功能。你可以从go-cqhttp的GitHub仓库下载适合你操作系统的版本。如果你希望机器人24小时运行，可以将项目部署到云服务器上。如果机器人没有响应，请检查go-cqhttp和NoneBot2的日志，确保两者都已正确连接。
LLOneBot 开源项目指南
gitblog_00410的博客
08-22 1197
LLOneBot 开源项目指南 项目地址:https://gitcode.com/gh_mirrors/ll/LLOneBot 一、项目目录结构及介绍 LLOneBot 是一个基于特定框架或语言构建的开源机器人项目，旨在提供灵活的消息处理能力。以下是该项目的基本目录结构及其简要说明： LLOneBot/ ├── bot.py # 主启动文件 ├── config ...
2024 QQ机器人可用框架汇总（1月更新）
m0_60496544的博客
01-14 1万+
2024.01 | QQ机器人可用框架汇总（持续更新）汇总目前网络可以的QQ机器人框架，合理利用，做遵纪守法公民，网络安全人人有责
基于SmartQQ的自动机器人框架SmartQQBot.zip
07-19
注意:此框架现已基本稳定，文档会尽快完善。 该分支使用二维码登陆的协议参考了原名：SmartQQ-for-Raspberry-Pi(PiWebQQV2)这一项目，自行整合开发了基于SmartQQ的自动机器人框架。 登陆时采用QQ安全中心的二维码做为登陆条件, 不需要在程序里输入QQ号码及QQ密码。 旧版机器人仍有保留在old_QQBot.py中。 基本功能 群聊功能： 注：以下命令皆是在qq中发送，群聊命令发送到所在群中 群聊吐槽功能(tucao)，类似于小黄鸡，在群中通过发送!learn {ha}{哈哈}语句，则机器人检测到发言中包含“ha”时将自动回复“哈哈”。!delete {ha}{哈哈}可以删除该内容。吐槽内容本地保存在data/tucao_save/中。 群聊复读功能(repeat)，检测到群聊中连续两个回复内容相同，将自动复读该内容1次。 群聊关注功能(follow)，使用命令!follow qq号可以使机器人复读此人所有发言（除命令外）使用命令!unfollow qq号解除关注。qq号处可使用"me"来快速关注与解除关注自己，例：!follow me 群聊唤出功能(callout)，群聊中检测关键词智障机器人，若发言中包含该词，将自动回复干嘛（‘·д·），此功能一般用于检测机器人状态与调戏 群聊命令功能(command_0arg/command_1arg)：使用![命令名]格式或![命令名] {参数1}执行命令，命令“吐槽列表”，使用命令!吐槽列表在群聊中激活，列出当前群的吐槽列表。 !删除关键字 {blablabla}:删除关键字“blablabla”下的所有吐槽内容 !吐槽列表:列出当前群的吐槽列表 现有无参数命令： 现有单参数命令: 私聊功能： 私聊唤出功能(callout)，私聊中检测关键词智障机器人，若发言中包含该词，将自动回复干嘛（‘·д·），此功能一般用于检测机器人状态与调戏 私聊复读功能(repeat)，检测到私聊中连续两个回复内容相同，将自动复读该内容1次。 临时对话功能： 唤出功能(callout)，具体同私聊与群聊。   标签：smartqq  smartqqbot
2024可使用的机器人框架
qq_50073789的博客
12-24 3776
最近查找可用的机器人框架，发现许多这种类型的文章都没有再次得到更新，所以我就来更新一下
2024小白菜QQ云端机器人系统源码 去除解密授权学习版源码
egrtgef的博客
11-26 2301
小白菜QQ云端机器人源码是一份专为群机器人爱好者设计的开源项目。这份源码基于挂机宝机器人框架，通过网页登录QQ账号至挂机宝框架中，无需借助机器人即可实现登录。与此前的授权版本相比，该源码已经全面解密，去除了授权版的限制，使用户能够更加自由地使用。该源码解决了框架只能对应一个机器人的问题，支持多个挂机宝，并且可以随意选择框架登录或者强制使用固定框架登录。当前版本支持小栗子框架、MYQQ、MYQQA等框架，未来还将支持更多优质框架。更新版本。
QQ搭建机器人
qq_44747927的博客
03-13 2376
官网搜索图灵机器人 QQ登陆图灵界面 搭建属于自己的机器人 可以跟机器人简单沟通，将机器人搭QQ 中实现QQ机器人
探索CoolQBot：一款强大的QQ机器人开发框架
gitblog_00069的博客
04-05 402
探索CoolQBot：一款强大的QQ机器人开发框架 去发现同类优质开源项目:https://gitcode.com/ 如果你正在寻找一个高效、易用且功能丰富的QQ机器人开发框架，那么可能是你的理想选择。这款开源项目基于Python，旨在简化QQ机器人的搭建和维护过程，让开发者能够快速构建个性化的聊天机器人。 项目简介 CoolQBot是基于CoolQ的API封装库，它将复杂的HTTP请求与消息处理...
Go-CleverQQ机器人框架Golang版SDK
08-13
CleverQQ机器人框架Golang版SDK
FastReport .net 中文详细教程及Demo
01-11
这个指南让你熟悉报表设计器和了解报表设计的基本概念（各种区域，数据源，二次表，等等）。...FastReport是一个已经拥有三年历史的非常成熟的报表设计器，成长使它拥有其它Delphi报表设计器所不能相比的诸多先进特性。
SSM框架——详细整合教程（Spring+SpringMVC+MyBatis）
热门推荐
在路上
07-19 64万+
使用SSM（Spring、SpringMVC和Mybatis）已经有三个多月了，项目在技术上已经没有什么难点了，基于现有的技术就可以实现想要的功能，当然肯定有很多可以改进的地方。之前没有记录SSM整合的过程，这次刚刚好基于自己的一个小项目重新搭建了一次，而且比项目搭建的要更好一些。以前解决问题的过程和方法并没有及时记录，以后在自己的小项目中遇到我再整理分享一下。这次，先说说三大框架整合过程。个人认
【愚公系列】2024年03月 《CTF实战：从入门到提升》 003-Web安全基础知识（HTTP安全）
时光隧道
02-26 8万+
HTTP安全是指在使用HTTP协议进行通信时，采取的一系列措施和技术，以确保传输过程中的数据的机密性、完整性和可信性。HTTP协议本身是一种明文的协议，数据在传输过程中容易被窃听、篡改或伪造。措施描述HTTPS在HTTP协议基础上增加了SSL/TLS加密层，通过对通信内容进行加密以保护数据的机密性。加密使用对称加密或非对称加密算法对敏感数据如用户登录信息或支付信息进行加密，防止数据被窃听。认证通过身份验证技术验证通信双方的身份，确保通信的可信性。
100天精通Python（爬虫篇）——第121天：基于selenium实现代码输入账号信息登录网站（反反爬策略）
努力让自己发光，对的人才能迎着光而来
02-26 16万+
基于selenium实现代码输入账号信息登录网站
100天精通Python（爬虫篇）——第122天：基于selenium和ddddocr库实现验证码识别登录（反反爬策略）
努力让自己发光，对的人才能迎着光而来
03-18 14万+
一、前言 二、ddddocr库使用说明 1. 介绍 2. 算法步骤 3. 安装 4. 参数说明 5. 纯数字验证码识别 6. 纯英文验证码识别 7. 英文数字验证码识别 8. 带干扰的验证码识别 三、验证码识别登录代码实战 1. 输入账号密码 2. 下载验证码 3. 识别验证码并登录
NoneBot2搭建官方QQ机器人-简单易上手
weixin_58403216的博客
12-25 6649
本文是使用最新版使用NoneBot2(2.4版本) + 官方QQ 频道/群聊 机器人(需要在QQ 开放平台申请创建机器人)。
搭建自己的AI智能QQ机器人，可实现单聊或者群聊，新手可看，手把手保姆级教学，可实现机器人托管自己的QQ，机器人可以定时发送消息，个性化定制机器人的类型
2401_83427145的博客
05-07 5165
搭建自己的AI智能QQ机器人，可实现单聊或者群聊，新手可看，机器人可以定时发送消息，个性化定制机器人的类型，可实现机器人托管自己的QQ，自定义机器人回复消息，可以定义群管家，或者自定义自己的AI小助手，可以快速上手，不需要任何难度，AI化的QQ机器人
基于mfc对话框的nt服务程序框架
05-16
基于MFC对话框的NT服务程序框架是在Windows系统下开发服务程序的一种基于MFC（Microsoft Foundation Class）对话框的框架架构。NT服务程序是一种在Windows系统下后台运行的程序，可以实现自动启动、无需用户交互、后台运行等功能。 基于MFC对话框的NT服务程序框架有以下特点： 1. 采用MFC对话框，可以方便地设计程序界面和交互方式，方便用户操作。 2. 可以通过类视图和资源视图快速查找和管理程序代码和资源。 3. 使用NT服务程序框架可以避免手动创建服务，可以减少代码的编写量和提高程序的可靠性和稳定性。 4. 使用NT服务程序框架可以方便地实现服务的启动、停止、暂停和重新启动等操作。 基于MFC对话框的NT服务程序框架的具体实现步骤如下： 1. 创建一个MFC对话框程序，设置项目类型为“服务程序”； 2. 在对话框程序中加入Windows服务管理相关代码，用于服务的开启、关闭、暂停和恢复等操作； 3. 实现服务程序的逻辑功能，例如对文件进行监控、实时数据同步等； 4. 编译、安装和启动服务，测试服务的功能和稳定性； 5. 在服务启动后，可以通过MFC对话框程序的用户界面和交互方式与服务进行交互。 综上所述，基于MFC对话框的NT服务程序框架使得开发Windows服务程序变得更加简单和高效，可以提高程序的可靠性和稳定性，并在服务启动后方便进行交互。
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

唤醒手腕

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值