HiklQQBot开源程序基于python的轻量qq官方机器人框架 快速部署启动官方QQ机器人 插件编写简单易懂 支持小白AI一键生成插件
一、软件介绍
文末提供程序和源码下载
HiklQQBot 开源程序是一个基于 Python 的 QQ 官方机器人框架，支持 WebSocket 和 Webhook 两种通信方式。本框架由 AI 辅助完成大部分编写，具有插件化设计，易于扩展和使用。
二、特性
- 🔌 双模通信: 支持 WebSocket 和 Webhook 两种通信方式，可通过配置文件轻松切换
- 🧩 插件化设计: 基于插件的模块化设计，便于扩展新功能
- 📦 开箱即用: 内置多个示例插件，快速开始使用
- 🔐 权限系统: 支持管理员权限控制和维护模式
- 📝 详细日志: 完善的日志记录系统，便于调试和问题排查
- ⚡ 异步处理: 使用 Python 异步特性，提高性能和并发处理能力
三、安装
系统要求
Python 3.7 或更高版本
推荐使用虚拟环境
- 步骤 文末提供下载源码，解压
cd hiklqqbot
创建并激活虚拟环境 (可选但推荐)
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/macOS
source venv/bin/activate
安装依赖包
pip install -r requirements.txt
配置环境变量
# 复制示例配置文件
cp .env.example .env
# 编辑 .env 文件，填写您的机器人凭据和配置
配置
打开 .env 文件，填写所需信息
如果使用 Webhook 模式，需要确保安装了相关依赖：
pip install pynacl
# 或者
pip install ed25519
运行
启动机器人：
python main.py
机器人启动后会自动加载所有插件，并根据配置文件选择通信模式。
四、通信模式
WebSocket 模式
WebSocket 模式是最简单的接入方式，机器人会主动连接到 QQ 机器人网关，建立长连接接收事件。
优点:
- 设置简单，无需公网 IP
- 无需额外配置即可直接使用
缺点:
- 需要维护心跳和重连机制
- QQ 官方计划在 2024 年底前逐步下线此模式（直到2025/4/17任然可以使用）
Webhook 模式
Webhook 模式需要提供一个可以被 QQ 机器人平台访问的 URL，用于接收事件推送。
优点:
- 不需要维护连接状态
- 官方推荐的长期稳定接入方式
缺点:
- 需要公网 IP 或域名，或者使用内网穿透工具
- 配置稍复杂
Webhook 配置步骤
- 在 .env 文件中设置 COMM_MODE=webhook
- 配置 webhook 相关参数
- 如果没有公网 IP，使用 ngrok 等工具进行内网穿透：
- ngrok http 8080
- 将获得的公网 URL 填入 QQ 机器人管理后台的回调地址中
五、软件下载
夸克网盘分享
本文信息来源于GitHub作者地址：https://github.com/kldhsh123/hiklqqbot