mirai

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

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

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 14811
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队mamoe
所属国家
定价模式free
价格说明开源项目,基于AGPL-3.0许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议AGPL-3.0
主要语言Kotlin
技术栈/模型chatbot,java,kotlin,mirai
GitHub 星标★ 14811
30天Star增速
HF 下载量
上线时间2019-08-07 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

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

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

环境要求

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

安装与启动步骤

  1. 1查阅用户手册

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

  2. 2获取项目源码

    从 GitHub 克隆 mirai 仓库到本地,方便查看源码与文档目录 docs/UserManual.md。

    git clone https://github.com/mamoe/mirai.git
  3. 3访问官方论坛

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

  4. 4加入在线讨论

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

如何确认成功

README 未给出启动校验方式;按用户手册完成部署后,登录的机器人账号应能正常收发消息。

常见问题

Q:如何快速部署一个 Mirai QQ 机器人?

A:阅读用户手册 docs/UserManual.md,其中说明如何快速部署机器人、安装插件并投入使用。

Q:遇到问题应该去哪里提问?

A:前往唯一官方论坛 Mirai Forum(https://mirai.mamoe.net/),也可通过 Gitter 在线讨论。

Q:mirai 是收费的吗?

A:完全免费且开源,不会通过任何方式强制收取费用,也不会对使用者提出物质条件。

Q:可以用于商业或非法用途吗?

A:不可以。README 声明一切开发旨在学习,仅供学习和娱乐用途,请勿用于非法用途。

注意事项

  • README 未提供具体安装命令,实际部署步骤请以 UserManual 为准。
  • mirai 只有唯一一个官方论坛 Mirai Forum,请注意甄别其他来源。
  • 项目采用 AGPL-3.0 许可证,二次分发与修改需遵守相应条款。
  • 项目由开源社区维护,所有贡献者享有其作品的著作权。

核心亮点

  • 协议实现稳定,消息收发延迟低,适合高频交互场景
  • API 设计清晰,事件驱动模型灵活,扩展性极强
  • 跨平台支持 JVM/Android,生态工具链完善(如 Mirai Console)

不足之处

  • QQ 协议逆向存在封号风险,需谨慎使用
  • 文档偏技术化,新手入门曲线较陡

适用场景

  • 社群自动管理(如入群欢迎、关键词回复)
  • 个人助手(如消息提醒、定时任务)
  • 游戏/工具类机器人(如查询、签到)

替代项目

NoneBot、go-cqhttp、Lagrange.Core

项目介绍

mirai 是对话助手领域的开源项目,由 mamoe 开发,2019 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(14,811)位列前 4%,在对话助手分类的 907 个项目里位列前 2%。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-22。基于AGPL-3.0许可证,完全免费,无付费版本。

它主要面向的使用场景是:社群自动管理(如入群欢迎、关键词回复)。同类可对比的替代方案包括 NoneBot、go-cqhttp、Lagrange.Core。

上一篇:chattermate.chat

下一篇:ChatterBot

同类项目推荐

open-webui 开源

给本地模型配个漂亮聊天室,全家都能用

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

★ 152821 2026-08-09
prompts.chat 开源

海量好提示词,抄了就能让 AI 更听话

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the commun···

★ 170999 2026-08-09
elia 开源

终端里用键盘快速聊 AI,多模型切换不打断思路

A snappy, keyboard-centric terminal user interface for interacting with large langua···

★ 2479 2026-08-09
NextChat 开源

一个界面聊遍所有主流AI模型,支持全平台部署,轻快又私密。

✨ Zero-config AI chat assistant. No API key needed — sign up and instantly chat wi···

★ 88802 2026-08-09