=Start=

缘由：

整理一下最近做的QQ机器人相关的资料，方便需要的同学参考。

正文：

参考解答：

1、酷Q

以前：基于 SmartQQ 协议（2019年1月3日该协议已废弃）；
现在：基于 手机QQ 协议；

以前的很多QQ机器人都是通过 WebQQ(SmartQQ协议) 和QQ进行的交互（在GitHub上可以搜到很多），但当2019年1月3日该协议废弃之后，现在还可用的基本都是基于酷Q来实现的QQ机器人。

酷Q 扮演着「无头 QQ 客户端」的角色，它进行实际的QQ消息、通知、请求的接收和发送，更多功能需要在它的基础上安装“应用/插件”来实现。接下来我们介绍一个简单易用的酷Q插件。

2、CoolQ HTTP API 插件

此插件通过 HTTP 或 WebSocket 对酷 Q 的事件进行上报以及接收请求来调用酷 Q 的 DLL 接口，从而可以使用其它语言编写酷 Q 插件。支持 Windows 7 和 Windows Server 2008 及更新版本，也可以运行在 Wine、Docker。

该插件起到的主要是接收、解析、转发QQ消息的作用。

3、简单使用样例

情形一：Windows系统

①下载——去「[发布]酷Q Air」页面下载酷Q Air；

②解压——下载完请解压后再从解压出来的文件中打开主程序，请不要直接从解压软件中打开。

③登录QQ——初次使用时软件会下载需要的程序文件，更新完成后，AIR版会直接进入登录界面，PRO版会进入提示授权界面，如果你已经有授权码，复制后粘贴到授权栏就可以进入登录界面了。

④安装CoolQ HTTP API 插件——先到 Releases 页面下载最新的 cpk 文件放到 酷Q 的 app 文件夹；（在登录成功后会看到你机器人的头像）右键单击该头像以显示酷Q的主菜单，然后在其中的「应用管理」处可以在此进行应用的管理，启用对应的插件即可。

注意！如果 酷Q 启动时报错说插件加载失败，或者系统弹窗提示缺少 DLL 文件，则需要安装 VC++ 2017 运行库（一定要装 x86 也就是 32 位版本！），如果你的系统是 Windows 7 或 Windows Server 2008、或者安装 VC++ 2017 运行库之后仍然加载失败，则还需要安装 通用 C 运行库更新，在这个链接里选择你系统对应的版本下载安装即可。如果此时还加载失败，请尝试重启系统。

⑤接收/发送QQ消息——在启用插件后，它将开启一个 HTTP 服务器来接收请求，默认监听 0.0.0.0:5700，首次启用会生成一个默认配置文件，在 酷Q 的 data\app\io.github.richardchien.coolqhttpapi\config 文件夹中，文件名为 <user_id>.json（<user_id> 为登录的 QQ 号），使用 JSON 格式填写。关于配置项的说明，见 配置。

• 接收。酷Q 收到的消息、事件会被 POST 到配置文件中指定的 post_url，为空则不上报。
• 发送。通过 http://192.168.1.123:5700/ 即可调用 酷Q 的函数，例如 http://192.168.1.123:5700/send_private_msg?user_id=123456&message=你好，注意这里的 192.168.1.123 要换成你自己电脑的 IP，如果在本地跑，可以用 127.0.0.1，user_id 也要换成你想要发送到的 QQ 号。具体的 API 列表见 API 描述。如果需要使用 HTTPS 来访问，见 HTTPS。

情形二：Linux/Mac系统

因为酷Q是Windows上的一个应用，所以可以在Windows系统上运行会比较简单直接。但借助于 Docker 我们也可以在大部分操作系统下使用最新版本的 酷Q 。（不过要注意的是：由于 wine 技术原理为 Windows 系统，实现与原生系统尚有差距，部分应用运行或有兼容性问题。）

①先安装docker

②在安装 docker 后，在命令行中键入以下命令下载 酷Q Docker 镜像：

docker pull coolq/wine-coolq

下载后，在任意目录创建一个空文件夹，用于持久化存放 酷Q 数据：

mkdir /root/coolq-data # 任意路径均可

然后运行 酷Q 镜像：
docker run -ti –name=coolq -d -p 8080:9000 -p 5700:5700-v /root/coolq-data:/home/user/coolq -e VNC_PASSWD=12345678 -e COOLQ_ACCOUNT=123456 coolq/wine-coolq

其中部分参数根据自己的需求替换，参见下表：

参数含义	参数示例
远程监听端口	8080
数据存放位置	/root/coolq-data
远程访问密码	12345678
机器人帐号	123456

运行如果没有报错，则说明已启动成功。此时，在浏览器中访问 http://你的服务器IP:你的端口 即可看到远程操作登录页面，输入密码，即可看到 酷Q Air 的登录界面啦。 在登录后，右键点击悬浮窗 -> 昵称 -> 勾选「自动登录」，即可保证 酷Q 能自动登录。 

【查看运行状况】

docker logs coolq

【启动/停止服务】

docker start coolq
docker stop coolq

③安装CoolQ HTTP API 插件 ④接收/发送QQ消息  在本地起一个简单的HTTP Server，监听在配置文件中设置的post_url地址，就可以在本地查看QQ收到的消息了。一个简单的Python Flask HTTP Server如下： 

#!/usr/bin/env python
# coding=utf-8

from flask import Flask, render_template, request

app = Flask(__name__)

@app.route("/", methods = ['POST','GET'])
def idx():
    if request.method == "POST":
        print( 'Headers: {0}'.format(request.headers) )
        print( 'Data: {0}'.format(request.get_data()) )
        return 'POST'

    if request.method == "GET":
        print( 'Headers: {0}'.format(request.headers) )
        print( 'Data: {0}'.format(request.get_data()) )
        return 'GET'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5702, debug=True)

参考链接：

• 酷Q是怎样获取QQ聊天消息的？
  https://www.zhihu.com/question/55241147
• [技巧]酷Q 使用手册 基础篇
  https://cqp.cc/t/35718
• [发布]酷Q Air 5.14
  https://cqp.cc/t/23253#pid873447
• [发布]酷Q on Docker 2.0
  https://cqp.cc/t/34558
• CoolQ HTTP API 插件
  https://cqhttp.cc/docs/4.10/#/Docker
• ==
• QQ聊天记录多角度分析Python实现
• QQ 聊天记录简单数据分析
• QQ群聊天记录分析

=END=