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("开始收集&…...
【Linux】shell脚本忽略错误继续执行
在 shell 脚本中,可以使用 set -e 命令来设置脚本在遇到错误时退出执行。如果你希望脚本忽略错误并继续执行,可以在脚本开头添加 set e 命令来取消该设置。 举例1 #!/bin/bash# 取消 set -e 的设置 set e# 执行命令,并忽略错误 rm somefile…...

MongoDB学习和应用(高效的非关系型数据库)
一丶 MongoDB简介 对于社交类软件的功能,我们需要对它的功能特点进行分析: 数据量会随着用户数增大而增大读多写少价值较低非好友看不到其动态信息地理位置的查询… 针对以上特点进行分析各大存储工具: mysql:关系型数据库&am…...

【项目实战】通过多模态+LangGraph实现PPT生成助手
PPT自动生成系统 基于LangGraph的PPT自动生成系统,可以将Markdown文档自动转换为PPT演示文稿。 功能特点 Markdown解析:自动解析Markdown文档结构PPT模板分析:分析PPT模板的布局和风格智能布局决策:匹配内容与合适的PPT布局自动…...
生成 Git SSH 证书
🔑 1. 生成 SSH 密钥对 在终端(Windows 使用 Git Bash,Mac/Linux 使用 Terminal)执行命令: ssh-keygen -t rsa -b 4096 -C "your_emailexample.com" 参数说明: -t rsa&#x…...
大数据学习(132)-HIve数据分析
🍋🍋大数据学习🍋🍋 🔥系列专栏: 👑哲学语录: 用力所能及,改变世界。 💖如果觉得博主的文章还不错的话,请点赞👍收藏⭐️留言Ǵ…...

10-Oracle 23 ai Vector Search 概述和参数
一、Oracle AI Vector Search 概述 企业和个人都在尝试各种AI,使用客户端或是内部自己搭建集成大模型的终端,加速与大型语言模型(LLM)的结合,同时使用检索增强生成(Retrieval Augmented Generation &#…...

Aspose.PDF 限制绕过方案:Java 字节码技术实战分享(仅供学习)
Aspose.PDF 限制绕过方案:Java 字节码技术实战分享(仅供学习) 一、Aspose.PDF 简介二、说明(⚠️仅供学习与研究使用)三、技术流程总览四、准备工作1. 下载 Jar 包2. Maven 项目依赖配置 五、字节码修改实现代码&#…...
大数据驱动企业决策智能化的路径与实践
📝个人主页🌹:慌ZHANG-CSDN博客 🌹🌹期待您的关注 🌹🌹 一、引言:数据驱动的企业竞争力重构 在这个瞬息万变的商业时代,“快者胜”的竞争逻辑愈发明显。企业如何在复杂环…...

Selenium 查找页面元素的方式
Selenium 查找页面元素的方式 Selenium 提供了多种方法来查找网页中的元素,以下是主要的定位方式: 基本定位方式 通过ID定位 driver.find_element(By.ID, "element_id")通过Name定位 driver.find_element(By.NAME, "element_name"…...

华为OD机考- 简单的自动曝光/平均像素
import java.util.Arrays; import java.util.Scanner;public class DemoTest4 {public static void main(String[] args) {Scanner in new Scanner(System.in);// 注意 hasNext 和 hasNextLine 的区别while (in.hasNextLine()) { // 注意 while 处理多个 caseint[] arr Array…...