先看下目录
免责声明:本文所涉及资源均来源互联网,仅供个人分享学习,严谨用于非法用途,否则后果自负,且与本文无关!
实战在后面,先来理顺一下QQ机器人这个乱七八糟的东西,简直太乱,各种框架各种项目满天飞,所以诞生了下面的QQ机器人的前世今生。想看实战的直接跳到下面的实战目录
QQ机器人最早可以追溯到Smart QQ,也就是WebQQ,参考:https://zh.wikipedia.org/wiki/Smart_QQ
WebQQ是腾讯于2009年9月15日正式推出的一项服务,该服务可以使用户在不安装QQ软件的情况下使用QQ的部分服务。该功能已于2019年1月1日停止运营[1]。
Web QQ顾名思义也就是网页上运行的QQ,这要做机器人那就太简单了,分析HTTP协议就行了,由此诞生了一些列的Web QQ机器人框架,说白了就是封装的HTTP协议而已
2019年1月1日,Smart QQ正式停止服务。[3]
目前(2021-01-31)在Github上还存在大量SmartQQ的项目,但是大多数都是归档或者失效的。
大概2011年左右,有了一个叫做的酷Q的项目,酷Q最开始也是用的Smart QQ的Web协议,Smart QQ关闭之后开始用安卓手机QQ的协议,具体是酷Q Air(免费)用的是手Q国际版,酷Q Pro(付费)用的是安卓Q,所谓实现安卓手机QQ协议就是把QQ.apk大卸八块,反编译找到关键源代码,比如登录之类,数据传输协议抓包查看,通过这些手段自己实现一个QQ客户端的意思,那么自己实现的客户端就可以进行功能扩展,算是制作QQ机器人的基础。
因为能用反编译+抓包的方式实现自己的QQ客户端,所以QQ机器人框架雨后春笋般涌现,由此诞生了一些优秀的机器人,比如:
但是,好景不长,在2020年8月,腾讯突然封杀这些机器人框架:
截至2020.8.2凌晨2:00
晨风框架死(腾讯律师函,作者进局子)
酷q框架停运(用户 违规非法行为,网站关闭,框架正常,Air一旦重启不可使用 Pro用到授权完为止)暂时可以使用
契约框架部分问题,服务器被踹(官方公告即将跑路)暂时可以使用
oq机器人停运(消息不明)
qr机器人停运(消息不明)
mypc框架论坛关闭(消息不明)
乾坤框架停运(消息不明)
华景机器人(跑路拜拜)
ono机器人(作者亲自强调跑路拜拜)
mirai框架(群验证消息:已跑路)
nanbot框架论坛上不去(不明)
轻语机器人(消息不明)
柠檬机器人(消息不明)
暂时已知部分正常框架
QQlight框架
小栗子机器人框架
qqmax lite CoCo (某些手机robot)
目前未知消息机器人软件(不出名)
大神机器人(来自百度,目前未知消息)
星空机器人(来自百度,目前未知消息)
晨风机器人作者被跨省传唤
晨风QQ机器人作者被跨省传唤,腾讯的起诉让群管理人人自危
Mirai 也是一个上面跑路的机器人框架,实现的也是安卓QQ协议,项目地址:https://github.com/mamoe/mirai
mirai 是一个在全平台下运行,提供 QQ Android 协议支持的高效率机器人库
这个项目的名字来源于
京都动画作品《境界的彼方》的栗山未来(Kuriyama mirai)
CRYPTON以初音未来为代表的创作与活动(Magical mirai)
图标以及形象由画师DazeCake绘制
看来这个框架的开发者是老二次元了,现在也只剩下开源的mirai了,虽然之前说说mirai作者也跑路了,但还真没看出来哪里跑了,mirai强调并且切实实行了**“一切开发旨在学习,请勿用于非法用途**”的准则,我估计是这个确保了mirai能安心地继续存在。
一切开发旨在学习,请勿用于非法用途
mirai 是完全免费且开放源代码的软件,仅供学习和娱乐用途使用
mirai 不会通过任何方式强制收取费用,或对使用者提出物质条件
mirai 由整个开源社区维护,并不是属于某个个体的作品,所有贡献者都享有其作品的著作权。
所以只要不是用于非法盈利之类的用途,是不会收到腾讯的律师函的。
上面所说的各种框架都只是机器人的各种实现,每个框架之间接口都不通用,编程语言也不尽相同,想要开发一个自己的机器人,换一套框架所有的代码都要推到重来,所以亟需一个规范统一各个框架,所以OneBot 诞生了,先来看看OneBot 是啥:
OneBot 标准
一个聊天机器人应用接口标准
简单
接口简单易懂,可轻松接入。
兼容性
兼容原 CQHTTP 插件,零负担迁移。
兼容原 CQHTTP 插件,这个标准和CQHTTP有啥关系?CQHTTP是酷Q的一个插件,这个插件可以提供HTTP协议的接口供第三方系统调用,这样就和具体语言无关,什么语言都可以调用机器人接口实现自己的逻辑,而且基于CQHTTP 已经实现了很多功能的机器人了,详情见上面优秀机器人框架,为了不让以前所有的优秀代码都要推倒重来,所以OneBot 干脆直接在CQHTTP 的基础之上指定标准,这就是典型的先有实现,后有标准的例子。
在这个标准的基础之上,有了各种编程语言的实现,我们称之为生态,如下
理论上,基于 OneBot 标准开发的任何 SDK、框架和机器人应用,都可以无缝地在下面的不同实现中切换。当然,在一小部分细节上各实现可能有一些不同,这也是本项目希望推动解决的问题。
项目地址平台核心作者备注richardchien/coolq-http-apiCKYUrichardchien可在 Mirai 平台使用 mirai-native 加载Mrs4s/go-cqhttpMiraiGoMrs4syyuueexxiinngg/cqhttp-miraiMiraiyyuueexxiinnggtakayama-lily/onebotOICQtakayamaYiwen-Chan/OneBot-YaYa先驱Kanri
MiraiGo就是GO语言实现的安卓QQ协议,API很原始,相当于一个类库,go-cqhttp是在MiraiGo的基础之上封装的HTTP协议和Websocket协议接口的框架,得益于GO语言先天的优势(资源占用少,运行简单,协程并发高),总之就是性能高,引用项目原话
在关闭数据库的情况下, 加载 25 个好友 128 个群运行 24 小时后内存使用为 10MB 左右. 开启数据库后内存使用将根据消息量增加 10-20MB, 如果系统内存小于 128M 建议关闭数据库使用.
本文选择go-cqhttp作为实战框架
来到了最激动人心的实战环节,先看一下OneBot 标准的接口列表,参考https://github.com/howmanybots/onebot/blob/master/v11/specs/api/public.md
- send_private_msg 发送私聊消息
- send_group_msg 发送群消息
- send_msg 发送消息
- delete_msg 撤回消息
- get_msg 获取消息
- get_forward_msg 获取合并转发消息
- send_like 发送好友赞
- set_group_kick 群组踢人
- set_group_ban 群组单人禁言
- set_group_anonymous_ban 群组匿名用户禁言
- set_group_whole_ban 群组全员禁言
- set_group_admin 群组设置管理员
- set_group_anonymous 群组匿名
- set_group_card 设置群名片(群备注)
- set_group_name 设置群名
- set_group_leave 退出群组
- set_group_special_title 设置群组专属头衔
- set_friend_add_request 处理加好友请求
- set_group_add_request 处理加群请求/邀请
- get_login_info 获取登录号信息
- get_stranger_info 获取陌生人信息
- get_friend_list 获取好友列表
- get_group_info 获取群信息
- get_group_list 获取群列表
- get_group_member_info 获取群成员信息
- get_group_member_list 获取群成员列表
- get_group_honor_info 获取群荣誉信息
- get_cookies 获取 Cookies
- get_csrf_token 获取 CSRF Token
- get_credentials 获取 QQ 相关接口凭证
- get_record 获取语音
- get_image 获取图片
- can_send_image 检查是否可以发送图片
- can_send_record 检查是否可以发送语音
- get_status 获取运行状态
- get_version_info 获取版本信息
- set_restart 重启 OneBot 实现
- clean_cache 清理缓存
快速浏览一遍然后头脑风暴一下你觉得通过这些接口可以干什么:
点歌机器人、天气预报机器人、成绩查询机器人、群管理机器人、群聊天敏感词检测机器人、邮件发送机器人…、可玩性足够高了吧
CentOS 7 64位 + go-cqhttp-v0.9.39
服务器可以是本地虚拟机也可以是VPS,为什么选Linux,因为更适合生产环境
如果需要其他版本的go-cqhttp版本,请访问发布页:https://github.com/Mrs4s/go-cqhttp/releases
这是一份最全的配置文档,需要修改的字段uin为QQ号,password为QQ密码,其他的按需修改,每个字段都有注释的,要改自己先看看这个字段干嘛用的
web_ui,不知道干嘛的先关掉,HTTP端口为5700,WS端口为6700(此例用HTTP不用WS,所以先把WS的关掉),这些都是默认的不用改,还有个上报端口后面再说,此处先不做解释
上面文件内容保存到~/QQBOT/config.json文件中
恭喜你来到了验证环节,此处可以分为常用IP登录和不常用IP登录,前者可以选择手机号接受验证码验证或者扫码验证,后者就比较麻烦了,需要进行滑块验证
将url拷贝到浏览器选择验证方式验证即可,比较简单
滑块验证就比较烦人了,建议参考作者给出的方案:https://github.com/Mrs4s/go-cqhttp/blob/master/docs/slider.md
此处我使用的是方案B: 使用专用工具,这个比较简单,方案A是抓包
需要注意的是使用专用工具手动完成滑块验证需要快速完成,否则会失败,每次验证的时间只有30s,有时候滑块点不动,需要重来,笔者反复了三次才完成滑块验证。
完成滑块验证别高兴太早,还要再次进行上面的扫码或验证码验证,相当于一个二次验证。
最后再次启动,如果出现类似下面输出,则说明登录成功
此时检测一下服务器5700端口是否在起监听
如果不通,则可能是要开防火墙端口,下面两者选其一
如果不需要在外网暴露接口则不用开防火墙端口
API参考https://github.com/howmanybots/onebot/blob/master/v11/specs/api/public.md
建议直接在服务器本地用curl命令调用,下面随便演示几个
user_id填写对方QQ号,message填写消息内容
返回的json如下,retcode为0表示成功,赶快看一下对方收到消息没!如果收到了说明搭建成功!
返回内容如下
其他的接口请参考上面的API文档,笔者试过了大多数读数据接口(get打头)的速度很快,一些写数据接口(set打头)会失败,比如点赞、退出群啥的,其他感兴趣的可自行测试
什么是事件?比如一个好友给你发消息,这就是一个消息事件,上面实现了给别人发消息,那么别人给自己发消息自己怎么知道?答案就是事件上报,机器人会将收到的消息异步发送到指定的端口,由业务逻辑系统处理
比如好友给我发一个:听《一千年以后》,机器人将消息事件上报给指定端口,该端口在监听的系统去网易云搜索《一千年以后》的资源,然后调用上面的发消息API发送给好友,这样才能形成一个业务闭环。
一个事件必须的字段比如事件发生时间、事件类型、事件内容等等,可以参考OneBot 标准:https://github.com/howmanybots/onebot/blob/master/v11/specs/event/README.md
有哪些事件呢?下面列举了所有的事件类型
- 消息事件
- 通知事件
- 请求事件
- 元事件
来看一下我们最关心的消息事件
- 私聊消息
- 群消息
和通知事件
- 群文件上传
- 群管理员变动
- 群成员减少
- 群成员增加
- 群禁言
- 好友添加
- 群消息撤回
- 好友消息撤回
- 群内戳一戳
- 群红包运气王
- 群成员荣誉变更
群成员增加可以干什么?自己细想吧,这里不过多透露了
此处简单起见,用nc监听一个端口接收来自机器人的事件上报,在9000端口起一个监听
上面机器人的配置文件config.json中,主要配置post_urls,配置成上面我们配置的9000端口:“127.0.0.1:9000”:secret
重新启动机器人,会发现nc监听的9000端口有如下输出,说明上报配置生效
Q: 为什么挂一段时间后就会出现 消息发送失败,账号可能被风控? A: 如果你刚开始使用 go-cqhttp 建议挂机3-7天,即可解除风控