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

最新推荐文章于 2025-11-17 06:50:37 发布

原创最新推荐文章于 2025-11-17 06:50:37 发布 · 3.2k 阅读

24 ·

CC 4.0 BY-SA版权

文章标签：

#机器人

该文章已生成可运行项目，

一、热门开源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	全平台	丰富	中等	开发者、技术爱好者
CoolQ	Windows	中等	低	企业用户、非技术运维
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机器人！")