GitHub测评：qqbot开源QQ机器人，Vue3后台+AI对话+群管一体化自托管方案

qqbot是一套基于 OneBot 协议的 QQ 机器人可视化管理平台，后端采用 Node.js + Express + MySQL，前端为 Vue 3 + Element Plus，提供完整的 Web 管理界面，无需修改代码即可完成绝大多数配置。
核心亮点在于将 AI 对话（接入任意 OpenAI 兼容接口）、Microsoft Edge TTS 免费语音、群管自动化（违禁词/刷屏检测）和关键词回复集成到同一套后台中，每个群组可独立配置菜单、人设、群管策略，互不干扰。
适合对 QQ 机器人感兴趣、希望自托管且不想手写大量代码的个人开发者或技术爱好者。整体上手门槛中等，有一定 Node.js / MySQL 基础即可完成部署。

项目信息

| 项目 | 内容 |

|——|——|

| 仓库地址 | https://github.com/yunmaxz/qqbot |

| Star 数量 | 0(站长用ai写的玩具而已) |

| 协议 | MIT 非商业许可证（允许个人学习与二次开发，禁止商业用途） |

| 官方文档 | 见 README |

| 技术栈 | Node.js 18+ · Express · MySQL 8 · Sequelize ORM · Vue 3 · Pinia · Element Plus · Vite · WebSocket · JWT · msedge-tts |

| OneBot 兼容端 | LLOneBot（Windows 推荐） |

适合场景

个人折腾/学习：想研究 OneBot 协议、Node.js 后端或 Vue 3 前端的开发者，这套项目是完整的全栈参考实现

小型群组自动化：需要在自己维护的 QQ 群中部署关键词自动回复、入群欢迎、违禁词过滤等基础群管功能

AI 对话机器人：想在群里或私聊中接入 DeepSeek、OpenAI 等 AI 接口，并给不同群/用户绑定不同人设

TTS 语音互动：希望机器人以语音条形式回复，且不想付费购买 TTS API（Edge TTS 完全免费）

多群差异化配置：每个群有独立菜单展示、独立群管策略、独立 AI 人设绑定

不适用以下场景：

生产/商业环境使用（许可证禁止商业用途，且账号安全风险较高）

需要微信/其他 IM 平台支持（仅适配 QQ + OneBot 协议）

完全零代码用户（部署仍需命令行操作和基本的 MySQL 配置）

踩坑记录

llbot在Linux下启动会稍微比较麻烦，win服务器中部署比较吃配置，2h4G小厂服务器虚标配置可能qq启动失败

部署命令

# 拉取代码
git clone https://github.com/yunmaxz/qqbot.git
# 一键安装前后端依赖
npm run install:all
# 编辑环境变量
复制.env.example文件重命名为.env 修改数据库配置信息
# 生成 JWT 密钥（填入 .env 的 JWT_SECRET）
npm run gen:secret
# 导入数据库（使用仓库根目录的 qqqqqq.sql）
直接宝塔里面导入就行
# 构建前端
npm run build
# 生产环境启动
npm start
# llbot Linux 后台运行
cd llbot
nohup ./start.sh > llbot.log 2>&1 &