QQBot 项目教程

QQBot 项目教程

项目地址:https://gitcode.com/gh_mirrors/qq/qqbot

1. 项目介绍

QQBot 是一个基于腾讯 SmartQQ 协议的 QQ 机器人，使用 Python 语言实现。它可以在 Linux、Windows 和 Mac OSX 平台下运行，支持通过扩展来实现各种功能，如监控、收集 QQ 消息、自动消息推送、聊天机器人等。

2. 项目快速启动

安装

在 Python 2.7/3.4+ 环境下使用，可以通过 pip 安装：

pip install qqbot

或者下载源码后，解压并运行以下命令：

pip install .

启动 QQBot

在命令行输入以下命令启动 QQBot：

qqbot

启动过程中会自动弹出二维码图片，需要用手机 QQ 客户端扫码并授权登录。启动成功后，会将本次登录信息保存到本地文件中。下次启动时，可以输入以下命令尝试从本地文件中恢复登录信息：

qqbot -q qq号码

操作 QQBot

QQBot 启动后，在另一个控制台窗口使用 qq 命令操作 QQBot。例如：

# 列出所有好友
qq list buddy

# 给好友“jack”发消息“你好”
qq send buddy jack 你好

3. 应用案例和最佳实践

案例1：聊天机器人

实现一个简单的聊天机器人，当收到特定消息时自动回复。

# -*- coding: utf-8 -*-
def onQQMessage(bot, contact, member, content):
    if content == '-hello':
        bot.SendTo(contact, '你好，我是QQ机器人')
    elif content == '-stop':
        bot.SendTo(contact, 'QQ机器人已关闭')
        bot.Stop()

将以上代码保存为 sample.py，并放到 ~/qqbot-tmp/plugins/ 目录下，然后加载插件：

qq plug sample

案例2：自动消息推送

定时向指定群组发送消息。

import time

def onQQMessage(bot, contact, member, content):
    if content == '-start':
        while True:
            bot.SendTo(contact, '定时消息推送')
            time.sleep(3600)  # 每小时推送一次

4. 典型生态项目

QQBot 插件系统

QQBot 支持通过插件扩展功能。插件可以实现自定义的消息响应、定时任务等功能。插件的加载和卸载可以通过 qq plug 和 qq unplug 命令进行管理。

HTTP API

QQBot 提供了 HTTP API 接口，供 web 前端开发者调用。例如，发送消息的 API 接口为：

http://127.0.0.1:8188/send/buddy/jack/hello

通过这些 API，可以方便地集成 QQBot 到其他系统中。

---

通过以上教程，您可以快速上手 QQBot 项目，并实现各种自定义功能。希望本教程对您有所帮助！

qqbot QQBot: A conversation robot base on Tencent's SmartQQ 项目地址: https://gitcode.com/gh_mirrors/qq/qqbot