mirai

用 Kotlin 快速构建稳定高效的 QQ 机器人

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 2462 🐛 待处理 297 👀 关注 135

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 14766

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，基于AGPL-3.0许可证，完全免费，无付费版本。

项目预览

项目数据

分类对话助手

开发团队mamoe

官网地址https://mirai.mamoe.net

GitHubhttps://github.com/mamoe/mirai

定价模式🏷️完全免费

价格说明开源项目，基于AGPL-3.0许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议AGPL-3.0

主要语言Kotlin

技术栈/模型chatbot,java,kotlin,mirai

GitHub 星标★ 14766

上线时间2019-08-07 00:00:00

代码更新2024-09-23

仓库体积94.6 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数4

项目介绍

mirai 是一个基于 Kotlin 的高效率 QQ 机器人支持库，旨在为开发者提供稳定、高效的 QQ 协议实现，解决第三方 QQ 机器人开发中协议逆向难度大、稳定性差的问题。它提供完整的 QQ 客户端协议封装，支持消息收发、群管理、好友管理、文件传输等核心功能，并拥有强大的事件系统，便于开发者构建自定义机器人逻辑。mirai 采用多平台设计，支持 JVM 和 Android，通过丰富的 API 和插件机制，降低了 QQ 机器人的开发门槛，广泛应用于自动化运维、社群管理、个人助手等场景。其社区活跃，文档完善，是 Java/Kotlin 开发者构建 QQ 机器人的首选框架。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 14766

技术标签

chatbot java kotlin

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 15 分钟部署方式：库/依赖 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

可访问 GitHub 与 mirai 官方论坛的网络环境
JVM 运行环境（mirai 支持 JVM 与 Android 全平台）
具备 Kotlin 或 Java 开发基础，便于集成机器人逻辑
用于登录的 QQ 账号（依据项目用途准备）

安装与启动步骤

1查阅用户手册

README 未直接给出安装命令，部署机器人、安装插件与投入使用的官方步骤都在用户手册中，请先通读。
2获取项目源码

从 GitHub 克隆 mirai 仓库到本地，方便查看源码与文档目录 docs/UserManual.md。
```
git clone https://github.com/mamoe/mirai.git
```
3访问官方论坛

遇到部署或使用问题时前往唯一官方论坛 Mirai Forum 检索帖子，README 未提供其他官方答疑渠道。
4加入在线讨论

可通过 Gitter 与其他使用者在线交流，README 给出了该讨论入口链接。