QQ机器人搭建
使用QQ官方机器人Python SDK和三方框架搭建QQ群聊机器人
文章目录
- 使用QQ官方机器人Python SDK和三方框架搭建QQ群聊机器人
- 前言
- 编写机器人代码
- 机器人监听群聊进行文字回复
- 机器人监听群聊进行图片回复
- 机器人监听群聊进行文件发送
- 机器人监听群聊进行视频发送
- 机器人监听群聊进行语音发送
- 致谢和更新
前言
本文基于 QQ官方Python SDK 和 三方框架aka🐱(进群了解) 搭建QQ群聊机器人,可以实现全局监听群聊。
介绍
QQ官方机器人Python SDK是QQ提供的一个用于搭建QQ机器人的开发工具包。通过使用该SDK,我们可以编写Python代码来实现QQ机器人的各种功能,如在群聊内接收消息、发送消息等。虽然官方机器人已经满足了基本需求,但是给到开发者的权限很少,无法全局监听群聊消息,本文提供将官方和三方机器人融合的python库:QQbot_Python
,实现全局监听的QQ机器人体系。
准备工作
在开始之前,确保你已经具备以下准备工作:
- 已安装Python环境(建议使用Python 3.x版本)
- 拥有一个QQ账号(用于创建三方机器人)
- 获得了官方QQ机器人的APPID和APPSERCET(用于创建官方机器人)
- 安装三方框架aka🐱(用于创建三方机器人)
安装相关SDK
使用pip命令来安装QQ官方机器人Python SDK和三方QQ机器人Python SDK:
pip install qq-botpy QQbot_Python -i https://pypi.org/simple
获取官方QQ机器人的APPID和APPSERCET
在使用SDK之前,我们需要先创建一个QQ官方机器人账号,并获取其账号的APPID和APPSERCET。具体步骤如下:
- 打开 QQ官方机器人管理平台
- 创建一个新的机器人账号,按照 教程 完成相关设置
- 在机器人管理平台中登录刚刚创建的机器人账号,获取其账号的APPID和APPSERCET
配置官方机器人IP白名单
在创建好了QQ机器人账号之后,我们打开 QQ官方机器人管理平台 ,在开发栏中找到开发设置,点击后在界面可以找到IP白名单,在这里你需要配置你的公网IP。如果你是本地开发,你可以使用curl ipconfig.io
或者 公网IP查询网站 来获取你的公网IP(⚠️本地开发时公网IP随时会变化);如果你已经要部署在服务器上面了,一般的云服务器都配置了公网IP。最后,将你获取的公网IP填入QQ官方机器人管理平台并保存即可。
配置三方机器人服务器
你需要安装 三方框架aka🐱(进群下载) ,并且启动正向ws和http监听,ws的端口需要是3001,http的端口需要是3000。
编写机器人代码
接下来,我们开始编写机器人代码。
创建配置文件
在你自己创建的项目的目录下添加配置文件:config.yaml
appid: "" # 填入你在前面步骤获取的APPID
secret: "" # 填入你在前面步骤获取的APPSERCET
机器人监听群聊进行文字回复
首先,分为两种情况:1.你没有配置三方服务器,你将无法享受三方机器人服务。2.你配置了三方机器人并且满足前面提到的要求。
情况一:未配置三方机器人
我们导入botpy库,创建机器人实例,进行群聊事件的监听,示例代码如下:
# -*- coding: utf-8 -*-
import asyncio
import osimport botpy
from botpy import logging
from botpy.ext.cog_yaml import read
from botpy.message import GroupMessage, Messagetest_config = read(os.path.join(os.path.dirname(__file__), "config.yaml"))_log = logging.get_logger()class MyClient(botpy.Client):async def on_ready(self):_log.info(f"robot 「{self.robot.name}」 on_ready!")async def on_group_at_message_create(self, message: GroupMessage):messageResult = await message._api.post_group_message(group_openid=message.group_openid,msg_type=0, msg_id=message.id,content=f"收到了消息:{message.content}")_log.info(messageResult)if __name__ == "__main__":# 通过预设置的类型,设置需要监听的事件通道# intents = botpy.Intents.none()# intents.public_messages=True# 通过kwargs,设置需要监听的事件通道intents = botpy.Intents(public_messages=True)client = MyClient(intents=intents)client.run(appid=test_config["appid"], secret=test_config["secret"])
运行结果如下:
关于官方机器人更多的示例代码请参考: 官方完整示例
情况二:配置了三方机器人
我们导入QQbot_Python库,创建机器人实例,进行群聊事件的监听,示例代码如下:
# -*- coding: utf-8 -*-
import os
import QQbot_Python
from QQbot_Python import logging
from QQbot_Python.ext.cog_yaml import read
from QQbot_Python.message import GroupMessagetest_config = read(os.path.join(os.path.dirname(__file__), "config.yaml"))_log = logging.get_logger()class MyClient(QQbot_Python.Client):def __init__(self, **kwargs):super().__init__(**kwargs)self.show_heartbeat_info = Falseself.show_system_message = Trueasync def on_group_at_message_create(self, message: GroupMessage):group_id = message.third_msg.get("group_id")user_id = message.third_msg.get("user_id")message_id = message.third_msg.get("message_id")_log.info(f"收到群{group_id}的@消息,用户{user_id},消息{message_id}")await message.send_text(group_id=group_id,user_id=user_id,text="你好,我是机器人")if __name__ == "__main__":intents = QQbot_Python.Intents(public_messages=True)client = MyClient(intents=intents)client.run(appid=test_config["appid"], secret=test_config["secret"])
运行结果如下:
机器人监听群聊进行图片回复
目前官方机器人并不支持群聊回复本地图片,具体以官方文档更新为准。但是使用本文的思路,可以实现回复图片功能,需要配置三方。示例代码如下:
# -*- coding: utf-8 -*-
import os
import QQbot_Python
from QQbot_Python import logging
from QQbot_Python.ext.cog_yaml import read
from QQbot_Python.message import GroupMessagetest_config = read(os.path.join(os.path.dirname(__file__), "config.yaml"))_log = logging.get_logger()class MyClient(QQbot_Python.Client):def __init__(self, **kwargs):super().__init__(**kwargs)self.show_heartbeat_info = Falseself.show_system_message = Trueasync def on_group_at_message_create(self, message: GroupMessage):group_id = message.third_msg.get("group_id")user_id = message.third_msg.get("user_id")message_id = message.third_msg.get("message_id")_log.info(f"收到群{group_id}的@消息,用户{user_id},消息{message_id}")if "/发送图片" in message.content:await message.reply(content="发送成功!")await message.send_image(group_id=group_id,summary="这是图片描述",file_image="1.png")if __name__ == "__main__":intents = QQbot_Python.Intents(public_messages=True)client = MyClient(intents=intents)client.run(appid=test_config["appid"], secret=test_config["secret"])
具体运行如下:
机器人监听群聊进行文件发送
目前官方机器人并不支持群聊回复本地文件,具体以官方文档更新为准。但是使用本文的思路,可以实现回复图片功能。需要配置三方。示例代码如下:
# -*- coding: utf-8 -*-
import os
import QQbot_Python
from QQbot_Python import logging
from QQbot_Python.ext.cog_yaml import read
from QQbot_Python.message import GroupMessagetest_config = read(os.path.join(os.path.dirname(__file__), "config.yaml"))_log = logging.get_logger()class MyClient(QQbot_Python.Client):def __init__(self, **kwargs):super().__init__(**kwargs)self.show_heartbeat_info = Falseself.show_system_message = Trueasync def on_group_at_message_create(self, message: GroupMessage):group_id = message.third_msg.get("group_id")user_id = message.third_msg.get("user_id")message_id = message.third_msg.get("message_id")_log.info(f"收到群{group_id}的@消息,用户{user_id},消息{message_id}")if "/发送文件" in message.content:await message.reply(content="发送成功!")await message.send_file(group_id=group_id,file_name="名称可自定义",file_path="botpy.log")if __name__ == "__main__":intents = QQbot_Python.Intents(public_messages=True)client = MyClient(intents=intents)client.run(appid=test_config["appid"], secret=test_config["secret"])
运行结果如下:
机器人监听群聊进行视频发送
目前官方机器人并不支持群聊回复本地视频,具体以官方文档更新为准。但是使用本文的思路,可以实现回复图片功能。需要配置三方。示例代码如下:
# -*- coding: utf-8 -*-
import os
import QQbot_Python
from QQbot_Python import logging
from QQbot_Python.ext.cog_yaml import read
from QQbot_Python.message import GroupMessagetest_config = read(os.path.join(os.path.dirname(__file__), "config.yaml"))_log = logging.get_logger()class MyClient(QQbot_Python.Client):def __init__(self, **kwargs):super().__init__(**kwargs)self.show_heartbeat_info = Falseself.show_system_message = Trueasync def on_group_at_message_create(self, message: GroupMessage):group_id = message.third_msg.get("group_id")user_id = message.third_msg.get("user_id")message_id = message.third_msg.get("message_id")_log.info(f"收到群{group_id}的@消息,用户{user_id},消息{message_id}")if "/发送视频" in message.content:await message.reply(content="发送成功!")await message.send_voice(group_id=group_id, file_path="test.mp4",file_name="可以自定义名称")if __name__ == "__main__":intents = QQbot_Python.Intents(public_messages=True)client = MyClient(intents=intents)client.run(appid=test_config["appid"], secret=test_config["secret"])
运行结果如下:
机器人监听群聊进行语音发送
目前官方机器人并不支持群聊回复语音,具体以官方文档更新为准。但是使用本文的思路,可以实现回复图片功能。发送的语音文件格式只支持silk格式。需要配置三方。示例代码如下:
# -*- coding: utf-8 -*-
import os
import QQbot_Python
from QQbot_Python import logging
from QQbot_Python.ext.cog_yaml import read
from QQbot_Python.message import GroupMessagetest_config = read(os.path.join(os.path.dirname(__file__), "config.yaml"))_log = logging.get_logger()class MyClient(QQbot_Python.Client):def __init__(self, **kwargs):super().__init__(**kwargs)self.show_heartbeat_info = Falseself.show_system_message = Trueasync def on_group_at_message_create(self, message: GroupMessage):group_id = message.third_msg.get("group_id")user_id = message.third_msg.get("user_id")message_id = message.third_msg.get("message_id")_log.info(f"收到群{group_id}的@消息,用户{user_id},消息{message_id}")if "/发送语音" in message.content:await message.reply(content="发送成功!")await message.send_record(group_id=group_id,file_path="my.ntsilk")if __name__ == "__main__":intents = QQbot_Python.Intents(public_messages=True)client = MyClient(intents=intents)client.run(appid=test_config["appid"], secret=test_config["secret"])
运行结果如下:
除此之外,还有发送引用消息和发送私聊消息功能,在这里就不赘述了。
致谢和更新
本项目采用的都是开源技术
致谢:QQ官方开发者 | 不方便透露姓名的三方
上次更新时间: 9/28/2024, PM
如果你想继续进行基于本文进行QQ机器人自定义搭建,请转至此篇文章阅读:
➡️ [于 2024/9/25 第2次更新] QQ 腾讯官方机器人搭建(更新中)
👻 交流学习
相关文章:

QQ机器人搭建
使用QQ官方机器人Python SDK和三方框架搭建QQ群聊机器人 文章目录 使用QQ官方机器人Python SDK和三方框架搭建QQ群聊机器人前言编写机器人代码机器人监听群聊进行文字回复机器人监听群聊进行图片回复机器人监听群聊进行文件发送机器人监听群聊进行视频发送机器人监听群聊进行语…...

flink设置保存点和恢复保存点
增加了hdfs package com.qyt;import org.apache.flink.api.java.functions.KeySelector; import org.apache.flink.api.java.tuple.Tuple2;import org.apache.flink.runtime.state.storage.FileSystemCheckpointStorage;import org.apache.flink.streaming.api.datastream.Dat…...

使用python获取百度一下,热搜TOP数据详情
一、查找对应链接 # 警告:以下代码仅供学习和交流使用,严禁用于任何违法活动。 # 本代码旨在帮助理解和学习编程概念,不得用于侵犯他人权益或违反法律法规的行为。 1、打开百度页面 百度一下,你就知道 2、点击F12 或 右键鼠标…...
Go conc库学习与使用
文章目录 主要功能和特点conc 的安装典型使用场景示例代码并行执行多个 Goroutines错误处理限制并发 Goroutines 数量使用 context.Context 进行任务控制 常见问题1. **任务中发生 panic**原因:解决方法: 2. **conc.Group 重复调用 Wait()**原因…...
大模型prompt先关
对于未出现的任务,prompt编写技巧: 1、假设你是资深的摘要生成专家,根据提供的内容,总结对应的摘要信息。请生成一个指令,指令中带有一个使用例子。直接提供给大型模型以执行此任务。 2、基于大模型提供的内容再进行二…...

尚品汇-自动化部署-Jenkins的安装与环境配置(五十六)
目录: 自动化持续集成 (1)环境准备 (2)初始化 Jenkins 插件和管理员用户 (3)工作流程 (4)配置 Jenkins 构建工具 自动化持续集成 互联网软件的开发和发布…...

【尚跑】2024铜川红色照金半程马拉松赛,大爬坡152安全完赛
1、赛事背景 2024年9月22日8点,2024铜川红色照金半程马拉松赛于照金1933广场鸣枪起跑! 起跑仪式上,6000位选手们合唱《歌唱祖国》,熟悉的旋律响彻陕甘边革命根据地照金纪念馆前,激昂的歌声凝聚心中不变的热爱。随着国…...

WPS中让两列数据合并的方法
有这样一个需求,就是把A列数据和B列数据进行合并(空单元格略过)具体实现效果如图下: 该如何操作呢? 首先在新的一列第一个单元格中输入公式"A1&B1" 然后回车,就出现了两列单元格数据合并的效…...

使用yum为centos系统安装软件以及使用(包含阿里云yum源配置)
centos系统配置阿里云yum源 因为centos7官方停止维护,自带yum源用不了了,所以可以更换成阿里云yum源 方法: 使用root权限执行以下语句 curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo CentOS…...

《深度学习》【项目】OpenCV 发票识别 透视变换、轮廓检测解析及案例解析
目录 一、透视变换 1、什么是透视变换 2、操作步骤 1)选择透视变换的源图像和目标图像 2)确定透视变换所需的关键点 3)计算透视变换的变换矩阵 4)对源图像进行透视变换 5)对变换后的图像进行插值处理 二、轮廓检测…...

Linux 线程互斥
前言 对于初学线程的伙伴来讲,多线程并发访问导致的数据不一致问题,总是让人陷入怀疑,很多人只是给你说加锁!但没有人告诉你为什么?本篇博客将详解! 目录 前言 一、线程互斥 • 为什么票会出现负数的情…...
【Redis 源码】6AOF持久化
1 AOF功能说明 aof.c 文件是 Redis 中负责 AOF(Append-Only File)持久化的核心文件。AOF 持久化通过记录服务器接收到的每个写命令来实现数据的持久化。这样,在 Redis 重启时,可以通过重放这些命令来恢复数据。 2 AOF相关配置 a…...

6.MySQL基本查询
目录 表的增删查改Insert(插入)插入替换插入替换2 Retrieve(查找)SELECT 列全列查找指定列查询查询字段为表达式为查询结果指定别名结果去重 WHERE 条件order by子句筛选分页结果 Update(更新)delete&#…...
Linux字符设备驱动开发
Linux 字符设备驱动开发是内核模块开发中的一个重要部分,主要用于处理字节流数据设备(如串口、键盘、鼠标等)。字符设备驱动的核心任务是定义如何与用户空间程序交互,通常通过一组文件操作函数进行。这些函数会映射到 open、read、…...

HTML5+JavaScript绘制闪烁的网格错觉
HTML5JavaScript绘制闪烁的网格错觉 闪烁的网格错觉(scintillating grid illusion)是一种视觉错觉,通过简单的黑白方格网格和少量的精心设计,能够使人眼前出现动态变化的效果。 闪烁的栅格错觉,是一种经典的视觉错觉…...

每日OJ题_牛客_拼三角_枚举/DFS_C++_Java
目录 牛客_拼三角_枚举/DFS 题目解析 C代码1 C代码2 Java代码 牛客_拼三角_枚举/DFS 拼三角_枚举/DFS 题目解析 简单枚举,不过有很多种枚举方法,这里直接用简单粗暴的枚举方式。 C代码1 #include <iostream> #include <algorithm> …...

[uni-app]小兔鲜-01项目起步
项目介绍 效果演示 技术架构 创建项目 HBuilderX创建 下载HBuilderX编辑器 HBuilderX/创建项目: 选择模板/选择Vue版本/创建 安装插件: 工具/插件安装/uni-app(Vue3)编译器 vue代码不能直接运行在小程序环境, 编译插件帮助我们进行代码转换 绑定微信开发者工具: 指定微信开…...

安全的价值:构建现代企业的基础
物理安全对于组织来说并不是事后才考虑的问题:它是关键的基础设施。零售商、医疗保健提供商、市政当局、学校和所有其他类型的组织都依赖安全系统来保障其人员和场所的安全。 随着安全技术能力的不断发展,许多组织正在以更广泛的视角看待他们的投资&am…...
门面(外观)模式
简介 门面模式(Facade Pattern)又叫作外观模式,提供了一个统一的接口,用来访问子系统中的一群接口。其主要特征是定义了一个高层接口,让子系统更容易使用,属于结构型设计模式。 通用模板 创建子系统角色类…...
kotlin flow 使用
1 创建flow 方式1 通过携程扩展函数FlowKt中的flow扩展函数可以直接构建flow,只需要传递FlowCollector收集器实现类就可以了 private fun create1(){val intFlow createFlow()println("创建int flow: $intFlow")runBlocking {println("开始收集&…...

微软PowerBI考试 PL300-选择 Power BI 模型框架【附练习数据】
微软PowerBI考试 PL300-选择 Power BI 模型框架 20 多年来,Microsoft 持续对企业商业智能 (BI) 进行大量投资。 Azure Analysis Services (AAS) 和 SQL Server Analysis Services (SSAS) 基于无数企业使用的成熟的 BI 数据建模技术。 同样的技术也是 Power BI 数据…...
【SpringBoot】100、SpringBoot中使用自定义注解+AOP实现参数自动解密
在实际项目中,用户注册、登录、修改密码等操作,都涉及到参数传输安全问题。所以我们需要在前端对账户、密码等敏感信息加密传输,在后端接收到数据后能自动解密。 1、引入依赖 <dependency><groupId>org.springframework.boot</groupId><artifactId...
Objective-C常用命名规范总结
【OC】常用命名规范总结 文章目录 【OC】常用命名规范总结1.类名(Class Name)2.协议名(Protocol Name)3.方法名(Method Name)4.属性名(Property Name)5.局部变量/实例变量(Local / Instance Variables&…...
鸿蒙中用HarmonyOS SDK应用服务 HarmonyOS5开发一个医院挂号小程序
一、开发准备 环境搭建: 安装DevEco Studio 3.0或更高版本配置HarmonyOS SDK申请开发者账号 项目创建: File > New > Create Project > Application (选择"Empty Ability") 二、核心功能实现 1. 医院科室展示 /…...
大语言模型如何处理长文本?常用文本分割技术详解
为什么需要文本分割? 引言:为什么需要文本分割?一、基础文本分割方法1. 按段落分割(Paragraph Splitting)2. 按句子分割(Sentence Splitting)二、高级文本分割策略3. 重叠分割(Sliding Window)4. 递归分割(Recursive Splitting)三、生产级工具推荐5. 使用LangChain的…...

[10-3]软件I2C读写MPU6050 江协科技学习笔记(16个知识点)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16...
聊一聊接口测试的意义有哪些?
目录 一、隔离性 & 早期测试 二、保障系统集成质量 三、验证业务逻辑的核心层 四、提升测试效率与覆盖度 五、系统稳定性的守护者 六、驱动团队协作与契约管理 七、性能与扩展性的前置评估 八、持续交付的核心支撑 接口测试的意义可以从四个维度展开,首…...
CMake控制VS2022项目文件分组
我们可以通过 CMake 控制源文件的组织结构,使它们在 VS 解决方案资源管理器中以“组”(Filter)的形式进行分类展示。 🎯 目标 通过 CMake 脚本将 .cpp、.h 等源文件分组显示在 Visual Studio 2022 的解决方案资源管理器中。 ✅ 支持的方法汇总(共4种) 方法描述是否推荐…...
MySQL账号权限管理指南:安全创建账户与精细授权技巧
在MySQL数据库管理中,合理创建用户账号并分配精确权限是保障数据安全的核心环节。直接使用root账号进行所有操作不仅危险且难以审计操作行为。今天我们来全面解析MySQL账号创建与权限分配的专业方法。 一、为何需要创建独立账号? 最小权限原则…...
Android第十三次面试总结(四大 组件基础)
Activity生命周期和四大启动模式详解 一、Activity 生命周期 Activity 的生命周期由一系列回调方法组成,用于管理其创建、可见性、焦点和销毁过程。以下是核心方法及其调用时机: onCreate() 调用时机:Activity 首次创建时调用。…...