5分钟搭好你的第一个QQ机器人自动回复、定时提醒、远程控制一次搞定【免费下载链接】qqbotQQBot: A conversation robot base on Tencents SmartQQ项目地址: https://gitcode.com/gh_mirrors/qq/qqbot你有没有过这样的时刻明明只是想在群里当个普通潜水员结果因为会点技术变成了群宠客服——新同事问入职流程你朋友问餐厅推荐你连家里的摄像头想远程开关都有人问你能不能搞定。运营小林就是其中之一。她管的三个社群里每天有上百条问题其实是重复的怎么报名几点上课链接在哪。她一边复制粘贴一边在内心咆哮这些话我能不能让电脑替我回答案是可以而且 5 分钟就能搞定。今天要安利的 QQ机器人 项目QQBot就是一个基于 Python 的 QQ 自动化机器人框架它像一个会编程的QQ管家装好之后它能替你收发消息、定时提醒、查询联系人、执行你写的任何脚本逻辑把琐碎的重复劳动全部交给代码。话不多说直接看它凭什么值得用。先亮个相QQBot 到底能干什么能力具体表现典型用法消息自动处理关键词触发回复、消息转发、被 感知客服机器人、群管理定时任务按 cron 规则在指定时间发消息打卡提醒、会议通知联系人管理查询好友、搜索群聊、读取群成员资料成员统计、定向通知插件化扩展一个插件一个功能可热插拔广告拦截、聊天记录等远程控制通过 QQ 消息触发本机命令远程开关机、任务调度更妙的是它的门槛你不需要理解 WebQQ 协议、不需要服务器、不需要前端只要会写最简单的 Python 函数就能拥有一台 24 小时在线的 QQ 机器人。适合谁运营、群主、学生党、喜欢折腾的极客还有所有想让电脑替自己上班的人。5分钟上手从安装到第一条自动回复整个流程就三步装、跑、写插件。先克隆项目并安装依赖需要 Python 2.7 或 3.4git clone https://gitcode.com/gh_mirrors/qq/qqbot cd qqbot pip install .然后在命令行输入qqbot启动。程序会弹出登录二维码用手机 QQ 扫一扫授权就完成登录了。第一次扫码之后登录信息会保存在本地下次直接qqbot -q 你的QQ号就能快速恢复登录不用反复扫码。接着创建你的第一个插件。在~/.qqbot-tmp/plugins/目录下新建一个文件mybot.pydef onQQMessage(bot, contact, member, content): if content 你好: bot.SendTo(contact, 你好呀我是你的QQ机器人) elif 时间 in content: from datetime import datetime now datetime.now().strftime(%Y-%m-%d %H:%M:%S) bot.SendTo(contact, 现在是 now)保存后在另一个终端窗口执行qq plug mybot机器人就上岗了——收到你好会问好看到时间会报时。从安装到跑起来真的只要 5 分钟。装好之后它能替你解决哪些实际问题场景一24 小时在线的客服助手做电商、开社群的朋友最头疼的就是重复答疑。把常见问题写进onQQMessage机器人就能顶替你值班def onQQMessage(bot, contact, member, content): if 价格 in content: bot.SendTo(contact, 现在下单享8折链接xxx) elif 发货 in content: bot.SendTo(contact, 当天16点前下单当天发出哦)这里的bot.SendTo就是给消息来源者好友或群回消息一行代码一次回复。规则越全你被 的次数越少。场景二到点自动打卡的学习委员定时任务用qqbotsched装饰器就能实现它支持完整的 cron 语法。比如每晚 10 点提醒学习群打卡from qqbot import qqbotsched qqbotsched(hour22, minute0) def checkin_reminder(bot): groups bot.List(group, 学习打卡群) for group in groups: bot.SendTo(group, 打卡时间到啦回复已打卡完成今日记录)bot.List(group, 群名)用来按名字找到目标群然后挨个发提醒。还有更复杂的写法hour8,12,18表示每天三个整点触发minute0-55/5表示每 5 分钟一次灵活度直接拉满。场景三拿 QQ 当远程遥控器把机器人和你的脚本接在一起QQ 消息就能变成控制指令。比如群里发--status机器人执行一段检查代码后把服务器状态汇报回来——人在外面家里的设备、服务器的情况照样一手掌握。它内部是怎么工作的一张图看懂很多新手担心这种东西是不是很玄乎。其实 QQBot 的架构非常清爽就一句话主线程负责登录和调度四个子线程各管一摊事。从上面这张 QQBot 运行流程图可以看到程序启动后依次经历读取配置 → 加载插件 → 获取二维码 → 等待扫码授权登录成功后主线程会拉起四个子线程各司其职轮询线程不断检查有没有新消息收到就交给onQQMessage处理间隔线程每 5 分钟触发一次onInterval适合做周期性的小动作终端服务器线程监听 8188 端口让你能在另一个终端用qq命令远程操作它调度线程负责执行qqbotsched注册的定时任务。所有事件最终汇入一个主循环统一处理。这个设计的好处是机器人反应快、互不阻塞而且你写的插件只会被调用永远不会跟底层协议纠缠——你只需要关注onQQMessage等几个回调函数怎么写。进阶玩法从能用到好用QQBot 的上限比想象中高不少值得挖掘的玩法主要有三个。插件化开发。每个功能就是一个独立的.py文件放在qqbot/plugins/或你的插件目录里即可。官方自带了好几个现成插件qqbot/plugins/sample.py是最简回复示例qqbot/plugins/sampleslots.py把九种回调函数onInit、onQrcode、onExit……全都演示了一遍抄作业就行。运行时还能用qq plug 插件名热加载、qq unplug 插件名热卸载改完代码不用重启非常爽。定时重启保活。官方默认插件qqbot/plugins/schedrestart.py支持每天固定时间重启机器人比如在配置里写pluginsConf: {qqbot.plugins.schedrestart: 8:00}每天早上 8 点自动重连配合掉线自动重启的开关长期稳定在线。配置文件定制。配置文件位于~/.qqbot-tmp/v2.x.conf支持多用户独立配置二维码显示方式GUI/邮箱/文本、termServerPort端口、开机自动加载的插件列表等都可以改。甚至可以在浏览器里通过http://127.0.0.1:8188/send/buddy/jack/hello这样的 HTTP 接口直接发消息给前端开发者留了后门很贴心。避坑锦囊新手最常踩的 4 个坑1. 二维码弹不出来怎么办Linux 下需要系统装了 gvfs-open 或 shotwellWindows 下要设置好 png 图片的默认打开程序。实在不行改成邮箱模式——配好mailAccount和mailAuthCode二维码直接发到邮箱里手机扫码更方便。2. 为什么登录状态一两天就掉线这是底层协议的限制登录 cookie 每 1~2 天会过期。解决办法就是组合拳打开自动重启再配合schedrestart插件每天定时重登一次基本能保持长期在线。3. 消息偶尔重复发送是怎么回事这是 QQ 服务器返回代码 1202 导致的。bot.SendTo(contact, msg, resendOn1202False)可以关掉自动重发缺点是可能漏发保持默认True则几乎不会漏但偶尔会重复。按你的场景取舍即可。4. 回调函数里能不能调qq命令千万别。在回调或定时任务里用os.system(qq send ...)会导致死锁——它会等命令执行完而命令要等它执行完。直接用bot.SendTo、bot.List这些接口就行。下一步动手试试如果你已经读到这儿说明这个 QQ机器人 确实让你心动了。那我的建议很直接今天就把 sample.py 跑起来。先克隆项目git clone https://gitcode.com/gh_mirrors/qq/qqbot照着官方示例qqbot/plugins/sample.py写个你好自动回复然后慢慢往上加功能定时提醒、群管理、远程命令……每一步都看得见效果成就感来得特别快。觉得有用的话点个收藏免得下次找不到如果这篇文章帮你少踩了坑欢迎转发给同样被重复回复折磨的朋友。折腾出什么好玩的玩法也欢迎回来交流——毕竟让机器人替我们打工才是现代人的终极偷懒之道呀。【免费下载链接】qqbotQQBot: A conversation robot base on Tencents SmartQQ项目地址: https://gitcode.com/gh_mirrors/qq/qqbot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考