当前位置：首页 > news >正文

Python QQ机器人完整指南：5分钟搭建智能消息助手

news 2026/6/30 0:23:30

Python QQ机器人完整指南：5分钟搭建智能消息助手

【免费下载链接】qqbotQQBot: A conversation robot base on Tencent's SmartQQ项目地址: https://gitcode.com/gh_mirrors/qq/qqbot

你是否想要一个能自动回复消息、定时提醒任务的智能QQ机器人？QQBot项目让你用Python轻松实现这一目标。这是一个基于腾讯SmartQQ协议的Python自动化工具，能够快速构建功能强大的QQ机器人，实现消息监控、自动回复、定时推送等实用功能，极大提升沟通效率和工作自动化水平。

🚀 为什么选择QQBot机器人？

QQBot基于Python开发，采用SmartQQ协议实现自动化消息处理。它支持跨平台运行，无论是Linux、Windows还是Mac OSX系统，都能轻松部署。这个项目特别适合需要自动消息处理、群组管理、信息监控等场景的用户，通过简单的Python脚本就能实现复杂的自动化任务。

图：QQBot主线程工作流程图，展示了从登录到消息处理的完整生命周期

⚡ 快速入门：5分钟启动你的第一个机器人

安装与启动

首先通过pip安装QQBot：

pip install qqbot

安装完成后，在命令行输入qqbot启动程序。系统会自动弹出二维码图片，使用手机QQ扫码登录即可。首次登录成功后，登录信息会自动保存，下次启动时可以使用qqbot -q 你的QQ号码快速登录。

基本操作命令

启动成功后，在另一个命令行窗口使用qq命令操作机器人：

# 列出所有好友 qq list buddy # 给好友发送消息 qq send buddy 好友名称 你好，这是自动消息 # 列出所有群组 qq list group

🔧 核心功能详解

消息自动回复系统

QQBot最强大的功能之一是插件系统。创建一个简单的自动回复插件非常简单：

def onQQMessage(bot, contact, member, content): if content == '你好': bot.SendTo(contact, '你好，我是自动回复机器人') elif content == '时间': import datetime now = datetime.datetime.now() bot.SendTo(contact, f'现在时间是：{now.strftime("%Y-%m-%d %H:%M:%S")}')

将这段代码保存为mybot.py，然后通过qq plug mybot命令加载插件，你的机器人就具备了智能回复能力。

定时任务系统

QQBot提供了强大的定时任务功能，可以轻松实现定时消息推送：

from qqbot import qqbotsched @qqbotsched(hour='9,12,18', minute='0') def morning_reminder(bot): gl = bot.List('group', '工作群') if gl is not None: for group in gl: bot.SendTo(group, '大家早上好！新的一天开始了！')

这个定时任务会在每天9:00、12:00、18:00自动向"工作群"发送问候消息。

联系人管理功能

QQBot提供了丰富的联系人管理接口：

# 获取好友列表 buddies = bot.List('buddy') # 搜索特定好友 jack_friends = bot.List('buddy', 'jack') # 获取群成员列表 group_members = bot.List(group_object)

📁 项目结构与模块说明

QQBot项目结构清晰，主要模块包括：

qqbot/qqbotcls.py- 核心机器人类定义
qqbot/mainloop.py- 主事件循环处理
qqbot/plugins/- 插件目录，存放扩展功能
qqbot/qcontactdb/- 联系人数据库管理
qqbot/qterm.py- 命令行终端接口

插件开发指南

创建自定义插件非常简单。只需在~/.qqbot-tmp/plugins/目录下创建Python文件，定义相应的回调函数即可。QQBot支持以下事件回调：

onInit()- 初始化时调用
onQQMessage()- 收到QQ消息时调用
onInterval()- 定时任务调用
onPlug()- 插件加载时调用
onUnplug()- 插件卸载时调用

🔌 高级功能配置

多种登录方式

QQBot支持多种二维码显示模式：

GUI模式- 自动弹出二维码图片（默认）
邮箱模式- 将二维码发送到指定邮箱
服务器模式- 在HTTP服务器中显示二维码
文本模式- 在终端中以文本形式显示

配置文件管理

配置文件位于~/.qqbot-tmp/v2.x.conf，可以配置：

{ "termServerPort": 8188, "qq": "123456789", "mailAccount": "your-email@example.com", "restartOnOffline": true, "plugins": ["myplugin"] }

💡 实用场景示例

场景1：工作群自动提醒

@qqbotsched(hour='10,15', minute='30') def work_reminder(bot): bot.SendTo(work_group, '休息一下，喝杯水吧！')

场景2：关键词自动回复

def onQQMessage(bot, contact, member, content): if '天气' in content: bot.SendTo(contact, '今天天气晴朗，温度25℃') elif '帮助' in content: bot.SendTo(contact, '我可以回答天气、时间等问题')

场景3：消息监控与转发

def onQQMessage(bot, contact, member, content): if contact.ctype == 'group' and '重要' in content: # 将重要群消息转发给指定好友 admin = bot.List('buddy', '管理员')[0] bot.SendTo(admin, f'收到重要消息：{content}')