WebBot
🤖 企业级QQ机器人管理平台,开箱即用的机器人管理解决方案
Install / Use
/learn @Yixuan997/WebBotREADME
QQ机器人管理系统
🤖 企业级QQ机器人管理平台,开箱即用的机器人管理解决方案
✨ 功能特点
🎯 核心功能
- 🔐 用户认证系统 - 支持多用户、角色权限管理
- 🤖 多机器人管理 - 统一管理多个QQ官方机器人
- 🌐 Webhook事件处理 - 基于QQ官方Webhook API,稳定可靠
- 📊 实时状态监控 - 机器人运行状态、消息统计、性能监控
📊 工作流系统
- 🎨 可视化编辑 - 拖拽节点构建自动化流程
- 🔧 丰富节点 - 条件判断、HTTP请求、消息发送等
- 🔌 多协议支持 - 同时支持QQ官方和OneBot协议
- 📦 导入导出 - 工作流配置一键分享
🛠️ 管理功能
- 📈 数据统计 - 消息量、用户活跃度等统计分析
- 📝 日志系统 - 分级日志记录,支持文件和Web查看
- ⚙️ 配置管理 - 灵活的配置系统,支持环境变量
- 📧 邮件服务 - 集成邮件通知功能
🚀 部署特性
- 🐍 Python原生 - 纯Python部署,跨平台兼容
- ⚡ 高性能 - 基于Flask的高效Web框架
- 🌍 生产就绪 - 支持多种WSGI服务器部署
- 📱 响应式UI - 基于Tabler框架的现代化界面
🏗️ 产品架构
核心技术
- 高性能: 基于Flask的高效Web框架
- 稳定可靠: QQ官方Webhook API,99.9%可用性
- 安全保障: 多层安全防护,企业级数据保护
- 易于扩展: 模块化设计,支持自定义工作流开发
系统架构
🌐 Web管理界面
↓
🔐 用户认证系统 ← → 👥 多用户管理
↓
🤖 机器人管理中心
↓
📊 工作流系统 ← → 📊 数据统计分析
↓
🌐 QQ Webhook API ← → 📝 日志监控系统
↓
💬 消息处理引擎
功能模块
- 🔐 用户认证 - 安全的多用户登录和权限管理
- 🤖 机器人管理 - 统一管理多个QQ官方机器人
- 📊 工作流系统 - 可视化构建自动化流程
- 📊 数据分析 - 实时统计和可视化报表
- 📝 日志监控 - 全方位的系统监控和日志记录
- ⚙️ 配置管理 - 灵活的系统配置和参数调优
🚀 快速开始
📋 系统要求
- Python: 3.10+
- 操作系统: Windows/Linux/macOS
- Redis: 6.0+ (推荐)
- 内存: 最低512MB,推荐1GB+
- 存储: 最低1GB可用空间
🐍 Python部署
1. 克隆项目
git clone https://github.com/Yixuan997/WebBot.git
cd WebBot
2. 创建虚拟环境
# Windows
python -m venv venv
venv\Scripts\activate
# Linux/macOS
python3 -m venv venv
source venv/bin/activate
3. 安装依赖
pip install -r requirements.txt
4. 启动服务
# 开发模式
python app.py
# 生产模式 (Linux)
gunicorn --config gunicorn_conf.py app:app
🌐 访问系统
启动成功后,通过浏览器访问:
- 管理界面: http://localhost:5000
- 首次登录: 系统将引导您创建管理员账号
- 配置机器人: 在管理界面添加您的QQ机器人信息
⚙️ 配置指南
🎯 快速配置
-
创建管理员账号
- 首次访问系统会自动引导创建
- 设置安全的用户名和密码
-
添加QQ机器人
- 在机器人管理页面点击"添加机器人"
- 填入QQ机器人的AppID和Secret
- 配置Webhook回调地址
-
创建工作流
- 访问工作流管理页面
- 创建自动化处理流程
- 配置触发条件和动作节点
📊 工作流系统
核心特性
- 🎨 可视化编辑 - 拖拽节点构建自动化流程,零代码实现复杂逻辑
- 🔧 丰富节点 - 关键词触发、条件判断、HTTP请求、发送消息、字符串处理等
- 🔌 多协议支持 - 同时支持QQ官方和OneBot V11协议
- 📦 导入导出 - 工作流配置一键分享,.workflow格式
节点类型
触发节点:
- 🔑 关键词触发 - 消息包含指定关键词时触发
- ⏰ 定时触发 - 支持 Cron 表达式定时执行
逻辑节点:
- 🔀 条件判断 - 支持简单/高级模式,多条件组合
- 🔁 循环遍历 - foreach 节点,支持列表循环处理
数据节点:
- 📝 设置变量 - 存储中间数据
- ✂️ 字符串处理 - 截取、替换、正则提取等
- 📄 JSON提取 - 从JSON数据中提取字段
- 💾 数据存储 - 持久化键值存储,支持增删改查
动作节点:
- 📤 发送消息 - 支持文本、图片、视频、语音、文件、Markdown、ARK等
- 🌐 HTTP请求 - 调用外部API
- 🔌 自定义端点 - 调用OneBot任意API,响应保存到
endpoint_response - 🖼️ HTML渲染 - 渲染模板为图片
变量系统
- 支持
{{variable}}模板语法 - 支持嵌套访问
{{response_json.data.url}}、{{raw_data.message[0].data.id}} - 节点间自动传递变量
- 内置变量:
message、user_id、group_id、raw_data、response_json、endpoint_response等
🆓 完全免费开源
✨ 免费特性
完整功能,永久免费:
- ✅ 无限制机器人数量
- ✅ 完整的Web管理界面
- ✅ 工作流系统支持
- ✅ 数据统计和监控
- ✅ 用户权限管理
- ✅ 邮件通知服务
- ✅ 跨平台部署支持
开源优势:
- 🔓 源码开放 - 完全透明,可自由修改
- 🛠️ 自主可控 - 数据安全,私有化部署
- 🔧 灵活定制 - 根据需求自由扩展功能
- 🤝 社区支持 - 活跃的开发者社区
🆓 适用场景
个人开发者:
- 学习QQ机器人开发
- 个人项目和兴趣爱好
- 技术研究和实验
企业用户:
- 内部工具和自动化
- 客服系统搭建
- 社群管理解决方案
- 无预算限制的完整功能
📚 功能说明
🤖 机器人管理
- 多机器人支持: 同时管理多个QQ官方机器人
- Webhook模式: 基于QQ官方Webhook API,稳定可靠
- 状态监控: 实时监控机器人运行状态和消息处理情况
- 配置管理: 灵活的机器人配置和权限设置
👥 用户系统
- 多用户支持: 支持多用户注册和管理
- 角色权限: 管理员、普通用户等不同权限级别
- 会话管理: 基于Redis的安全会话管理
- 邮件验证: 支持邮件验证和通知功能
📊 工作流系统
- 可视化编辑: 拖拽节点构建自动化流程
- 丰富节点: 触发、条件、数据处理、动作等多种节点
- 多协议: 同时支持QQ官方和OneBot V11协议
- 导入导出: 工作流配置一键分享
- 优先级管理: 多工作流按优先级排序执行
- 实时缓存: 高性能的内存缓存系统
📊 监控统计
- 消息统计: 消息发送/接收量统计
- 用户活跃度: 用户使用情况分析
- 系统性能: CPU、内存使用情况监控
- 日志系统: 分级日志记录和Web查看
🛠️ 运维支持
📊 系统监控
实时监控面板:
- 🖥️ 系统状态 - CPU、内存、磁盘使用情况
- 🤖 机器人状态 - 在线状态、消息处理量
- 📈 性能指标 - 响应时间、吞吐量统计
- 🔔 告警通知 - 异常情况自动通知
日志管理:
- 📝 分级日志 - 错误、警告、信息等不同级别
- 🔍 日志搜索 - 快速定位问题和事件
- 📊 日志统计 - 可视化的日志分析报表
- 💾 日志归档 - 自动清理和长期存储
🔧 维护工具
数据管理:
- 💾 自动备份 - 定时备份重要数据
- 🔄 一键恢复 - 快速恢复系统状态
- 📤 数据导出 - 支持多种格式导出
- 🔄 版本升级 - 平滑的系统版本升级
性能优化:
- ⚡ 缓存优化 - 智能缓存策略提升性能
- 🗄️ 数据库优化 - 自动索引和查询优化
- 🔧 参数调优 - 根据使用情况自动调整参数
🎁 开源项目
🌟 项目特色
完全开源免费:
- 🆓 永久免费使用,无任何限制
- 🔓 源码完全开放,可自由修改
- 🛠️ 支持私有化部署,数据安全可控
- 🤝 欢迎社区贡献和反馈
持续更新:
- 🔄 定期功能更新和Bug修复
- 📚 不断完善的文档和教程
- 🎯 根据用户反馈优化功能
- 🌱 活跃的开发者社区支持
📞 联系我们
🛠️ 技术支持
获取帮助:
- 📧 邮件支持: 项目相关问题和建议反馈
- 🐛 GitHub Issues: 提交Bug报告和功能请求
- 📚 文档中心: 查看完整的使用和开发文档
- 🤝 社区讨论: 参与开发者交流和经验分享
技术交流:
- 🔧 部署指导: 社区提供免费的部署和配置帮助
- 💡 功能建议: 欢迎提出新功能和改进建议
- 🎯 工作流开发: 工作流开发技术交流和指导
- 📖 学习资源: 丰富的学习教程和示例代码
🤝 开源社区
参与方式:
- 🌟 Star项目: 如果觉得项目有用,请给个Star支持
- 🐛 Bug反馈: 发现问题及时反馈给社区
- 💡 功能建议: 提出有价值的功能改进建议
- 🔧 代码贡献: 参与项目开发,提交Pull Request
- 📚 文档完善: 帮助完善项目文档和教程
🎯 立即开始
快速体验:
- 免费下载 - 立即部署体验完整功能
- 社区交流 - 加入开发者社区获取帮助
- 自由定制 - 根据需求自由修改和扩展
现在就开始您的QQ机器人管理之旅!
<div align="center">
🤖 让QQ机器人管理变得简单高效!
© 2026 QQ机器人管理系统 - 完全免费的开源机器人管理解决方案
</div>