热爱技术
专注分享

使用python打造一个自己的QQ机器人 【基础篇】

webQQ在今年1月已经停止服务了。想用python写一个QQ机器人,但是python的QQbot库因为webQQ停止服务,挂得不能再彻底了。后来google了好几天,终于在github找到了一个神奇的插件=coolq-http-api

这个插件的神奇之处在于,它运行一个server,把qq信息转成http形式。发送,接收信息的时候,只需要使用http请求,即可和server进行交互,非常方便,也非常使用python(requests库无敌)。当然,插件运行基于酷Q,需要用酷Q加载插件才能正常使用。

要实现用python发送/接收消息,要用requests发送http请求之外,还要用flask在本地搭建一个flask服务端,告知插件flask服务器的地址和端口,这样所有的qq消息都会自动传递给flask,我们可以根据消息的来源,内容,自动判断是否要回复(用requests向酷Q进行http请求)即可。原理图如下:

一、 准备工作

  1. 酷Q下载安装: https://cqp.cc/t/23253 下载任意版本,右键解压即可使用。
  2. 插件下载安装: https://github.com/richardchien/coolq-http-api/releases 下载cpk文件,放到酷Q的app文件夹中
  3. python下载安装:这个就不说了,说太多次了,去官网下载安装包,一键安装就行了,注意要使用python3版本。
  4. python IDE下载安装:推荐使用pycharm,具体安装过程略。也是一键安装。

搞定后你的酷Q app文件夹下应该是这样的:

  • 启动酷Q主目录下的CQA.exe,打开酷Q登录你要做机器人的QQ号,建议使用小号,防止被封。
  • 由于酷Q使用的是手机TIM协议,成功上线后, 你可以看到小号为TIM在线。
  • 右键酷Q的小图标,进入应用管理,找到HTTP API直接启用。

成功启用后,会弹出一个控制台窗口,提示正在监听5700端口。

二、 配置酷Q httpApi插件

插件的配置文档: http://richardchien.gitee.io/coolq-http-api/docs/
配置文件在酷Q Air\data\app\io.github.richardchien.coolqhttpapi\config 文件夹下,是一个以QQ名称命名的json文件。
以下几项配置比较关键:

  • port : 酷Q server监听的端口,可自定义。
  • use_http:务必是true,除非你使用websocket。
  • post_url:flask服务端接收消息的接口,可自定义。
  • post_message_format:酷Q向flask发送消息的格式,建议改成array。

其他的配置项可见文档: https://richardchien.gitee.io/coolq-http-api/docs/4.12/#/Configuration?id=%E9%85%8D%E7%BD%AE%E9%A1%B9
附上自己的简单配置:

三、用python发送自己的第一条QQ消息

先悄悄用pip安装一个requests库….
插件的api文档: https://richardchien.gitee.io/coolq-http-api/docs/4.12/#/API
我们看下发送私聊消息的接口:

用requests构造一个http post请求,post的数据填入相关信息:

import requests

data = {
    'user_id':723690032,
    'message':'我是一个可爱的小机器人喵~',
    'auto_escape':False
}

api_url = 'http://127.0.0.1:5700/send_private_msg'
#酷Q运行在本地,端口为5700,所以server地址是127.0.0.1:5700

r = requests.post(api_url,data=data)
print(r.text)

四、接收第一条QQ消息

同样先悄咪咪安装一个flask….

from flask import Flask,request
from json import loads

bot_server = Flask(__name__)

@bot_server.route('/api/message',methods=['POST'])
#路径是你在酷Q配置文件里自定义的
def server():
    data = request.get_data().decode('utf-8')
    data = loads(data)
    print(data)
    return ''

if __name__ == '__main__':
    bot_server.run(port=5701)
    #端口也是你在酷Q配置文件里自定义的

运行一下这个flask程序,然后用自己的QQ给你的机器人随便发条信息:

{'font': 65320440, 'message': [{'data': {'text': '你才不是可爱的小机器人呢'}, 'type': 'text'}], 'message_id': 8, 'message_type': 'private', 'post_type': 'message', 'raw_message': '你才不是可爱的小机器人呢', 'self_id': 766202408, 'sender': {'age': 0, 'nickname': 'Misery_', 'sex': 'unknown', 'user_id': 723690032}, 'sub_type': 'friend', 'time': 1573044578, 'user_id': 723690032}

控制台打印的内容是一个python的字典格式,我们可以优化一下,取出需要的信息,如QQ号,昵称,消息内容:

QQ = data.get('user_id')
nickname = data['sender'].get('nickname')
message = data['message'][0]['data'].get('text')
print('来自QQ:{},昵称:{} 的信息:\n{}'.format(QQ,nickname,message))

五、后记

到这里,你就写出了一个hello world QQ机器人,想实现更多的功能,需要多去研究研究API,多研究研究python。这个插件功能相当强大,几乎涵盖了所有的QQ功能。博主曾经写过一个,可以对接某面板,涵盖登录,查询,支付等多种功能,并带有群管模块,接入阿里云tts语音系统,实现语音聊天。真的非常强大,有兴趣的同学可以好好研究一下。

赞(27) 打赏
未经允许不得转载:小伟博客 » 使用python打造一个自己的QQ机器人 【基础篇】

评论 6

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
  1. #1

    博主,第一个发送消息,pycharm出现d1循环是什么意思

    dong4年前 (2020-03-01)回复
  2. #2

    你好,我在应用管理里没有发现新下载cpk,可能是什么原因?

    li_il4年前 (2020-03-22)回复
    • 酷Q前几天倒闭了!

      misery4年前 (2020-08-04)回复
      • 现在不能用了吗

        32233年前 (2020-12-01)
  3. #3

    关于在docker上面运行的时候报出A VNC is already running as : 11的错误,novnc都不可以打开。(运行命令如下)
    docker run -ti –rm –network=host –name cq -v /home/wt/coolq/coolq-data:/home/user/coolq -p 8080:9000 -p 5700:5700 -e COOLQ_ACCOUNT=3303907850 -e CQHTTP_SERVE_DATA_FILES=yes -e VNC_PASSWD=12345678 -e COOLQ_URL=https://dlsec.cqp.me/cqp-full richardchien/cqhttp:latest

    孤风4年前 (2020-06-10)回复

觉得文章有用就打赏一下文章作者

非常感谢你的打赏,我们将继续给力更多优质内容,让我们一起创建更加美好的网络世界!

支付宝扫一扫打赏

微信扫一扫打赏