当前热门的QQ机器人开源项目推荐、功能对比及搭建教程，涵盖主流框架和实战指南

一、热门开源QQ机器人项目推荐 1. Mirai 特点： 全平台支持（Windows/Linux/macOS），支持QQ Android协议，消息处理高效稳定。提供插件扩展机制，支持

一、热门开源QQ机器人项目推荐

1. Mirai

特点：

全平台支持（Windows/Linux/macOS），支持QQ Android协议，消息处理高效稳定。提供插件扩展机制，支持自动回复、群管理、消息过滤等基础功能，可二次开发定制。社区活跃，网页完善，适合开发者和技术爱好者。 适用场景：社群管理、自动客服、娱乐互动。项目地址：GitHub

2. CoolQ

特点：

跨平台框架，支持HTTP插件（如cqhttp-mirai），提供API接口和插件市场。支持消息推送、群管理、定时任务，适合非技术用户通过插件快速搭建。 适用场景：企业客服、社群自动化。项目地址：GitHub

3. hoshino-bot

特点：

基于NoneBot框架，支持Python开发，内置丰富插件（如天气查询、游戏辅助）。支持多模态交互（文本、图片），可对接第三方API（如百度翻译、网易云音乐）。 适用场景：个人娱乐、技术学习。项目地址：GitHub

4. LangBot

特点：

支持多平台（QQ/微信/飞书）和多模型（GPT-4、Claude、Gemini），提供Web管理面板。内置插件系统，支持数据分析、内容创作等高级功能，适合企业级应用。 适用场景：智能客服、数据分析、跨平台管理。项目地址：GitHub

5. 陌路云端

特点：

完全免费开源，模块化设计，支持自动回复、群管、数据统计等。提供详细部署教程，适合新手快速搭建。 适用场景：个人助手、小型社群管理。项目地址：GitHub

二、热门项目功能对比

项目跨平台支持插件生态学习难度适用人群Mirai全平台丰富中等开发者、技术爱好者CoolQWindows中等低企业用户、非技术运维hoshino-bot全平台丰富中等Python开发者、极客LangBot多平台企业级高企业开发者、数据分析师陌路云端全平台基础低新手、个人用户

三、手把手搭建QQ机器人教程（以Mirai为例）

环境准备

安装Python 3.7+：下载地址安装依赖库：pip install nonebot2 go-cqhttp

配置go-cqhttp

下载并解压go-cqhttp。修改config.yml：account:

uin: 你的QQ号

password: 密码

message:

post-format: array

servers:

- http:

host: 127.0.0.1

port: 5700

运行登录：./go-cqhttp

创建NoneBot2项目

初始化项目：nb create

配置pyproject.toml：[tool.nonebot]

adapters = ["nonebot.adapters.cqhttp"]

编写插件（如自动回复）：from nonebot import on_command

from nonebot.adapters.cqhttp import Bot, Event

hello = on_command("hello")

@hello.handle()

async def handle_hello(bot: Bot, event: Event):

await hello.finish("你好，我是QQ机器人！")

运行与测试

启动机器人：nb run

在QQ中发送/hello，机器人将回复预设消息。

四、扩展功能参考

群管理：自动踢人、欢迎新人（参考的树莓派控制案例）。多模态交互：接入GPT-4实现智能问答（参考的LangBot设计）。定时任务：天气查询、新闻推送（参考的天气插件）。

五、注意事项

防封号：避免高频消息，使用代理IP（参考的防封指南）。合规性：遵守QQ机器人协议，禁止用于非法用途。

以上项目和教程均基于开源社区资源，可根据需求选择框架并灵活扩展。