2020年,手把手教你打造Python QQ机器人
都已经2020年了,smart qq早就于2019年光荣下线,伴随着他的离开,qqbot也不再维护,以往的基于smart qq和qqbot的QQ机器人的设计模式也已经不复存在,今天,笔者将带来一种全新的Python QQ机器人设计方式,基于python nonebot库和cool Q打造QQ机器人。
组件介绍
cool q为何物?
酷Q官网
酷Q是一个“简洁,轻盈,强大,免费”的qq机器人应用程序,甚至可以在群晖上搭建这样的一套系统,非常实用。官方将酷Q分为两种不同的版本,一个是酷Q Air,另一个是酷Q Pro。这种命名习惯与某果十分相似~
对于两种不同版本的区别,官方给出了下图的解释
![]()
两种版本在下载时都是免费的,但是实际使用时pro版本是需要支付一定的费用的,笔者在这里就用Air版本进行QQ机器人的制作
nonebot库为何物?
nonebot库是一个基于酷Q的 Python 异步QQ机器人框架 ,官方给出了以下三种特性:
1.简洁——提供极其简洁易懂的 API,使你可以毫无压力地开始验证你的绝佳创意,只需编写最少量的代码,即可实现丰富的功能。
2.易于扩展——精心设计的消息处理流程及强大的 API 使得你可以很方便地将最简单的原型变为具有大量实用功能的完整聊天机器人,并持续保证扩展性。
3.高性能——基于时下流行的 asyncio 模块,利用 WebSocket 进行通信,以获得极高的性能;同时,支持使用多个机器人账号来负载均衡用户消息,减少业务宕机的可能。
开始准备
接下来就正式开始搭建!
-
安装酷Q
点击进入酷Q官网安装

笔者使用的是酷Q Air小i版,不过既然我们选择使用Python来进行机器人的开发,所以具体选择图灵版还是小i版就显得不那么重要了。
- 为酷Q安装HTTP API插件

进入GitHub中之后点击第一项下载即可。下载完成之后,我们需要打开酷Q的文件夹,在\酷Q Air\app目录下将我们下载的HTTP API插件粘贴进去

之后,我们运行酷Q应用程序CQA.exe,并且输入qq号和密码登录,之后在任务栏中找到酷Q的图标并用鼠标右键点击,找到【应用】-【应用管理】并进入配置界面。

找到HTTP API插件,并且点击右下侧的【启用】按钮。由于笔者已经启用了,因此按钮变成了停用。

-
配置酷Q HTTP API插件
完成上述步骤之后,我们在酷Q文件夹中的
\酷Q Air\data\app\io.github.richardchien.coolqhttpapi\config目录中找到<刚刚登录的QQ号>.json文件,并且用记事本或者其他文本编辑器打开编辑。按照图中的标注修改配置文件后保存退出。

至此为止,关于酷Q的准备已经完成。
-
安装python库
接下来使用pip安装nonebot库
pip install nonebot
安装完成后,我们的所有工具准备就已经完成。
运行Python demo程序
我们创建一个python文件,并且运行官方的demo代码
import nonebot
if __name__ == "__main__":
nonebot.init()
nonebot.load_builtin_plugins()
nonebot.run(host='127.0.0.1', port=8080)
运行程序,如果在控制台中出现下面的内容,则表明配置成功,python正在监听qq消息

此时我们便可以测试运行效果,向刚刚我们登录酷Q的qq号发送一条消息
/echo <content>

这样我们就可以看到机器人重复我们和它说的话了。
异常处理
有时候,我们本地的127.0.0.1 8080端口可能会被占用导致运行python程序的时候产生如下错误:
OSError [WinError 10013]以一种访问权限不允许的方式做了一个访问套接字的尝试
这时候我们使用管理员模式运行一个cmd窗口,输入
netstat -ano|findstr 8080

这时候可以看到有一个进程号为 18292 的进程占用了我们的8080端口,我们需要将这个进程kill掉,在cmd窗口中继续输入
taskkill /pid <进程号> /F
如本例子中我们需要kill 18292进程,所以输入taskkill /pid 18292 /F
这样重新运行python程序就不会出现刚才的异常了。
结束语
以上就是打造qq机器人的基本步骤,本教程持续更新~