使用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 Airdataappio.github.richardchien.coolqhttpapiconfig 文件夹下，是一个以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语音系统，实现语音聊天。真的非常强大，有兴趣的同学可以好好研究一下。