需要 Python 3.12+ 环境;需自行准备大语言模型接入配置;README 未给出默认端口等运行细节,需查部署教程
MaiBot
Mai-with-uGPL-3.0活跃维护基于大语言模型的 QQ 聊天机器人,主打拟人化对话风格,追求温暖真实的互动体验而非效率,适合搭建有情感陪伴感的群聊助手。
MaiSaka, an LLM-based intelligent agent, is a digital lifeform devoted to understanding you and interacting in the style of a real human. She does not pursue perfection, nor does she seek efficiency; instead, she values warmth, authenticity, and genuine connection.
从 https://github.com/Mai-with-u/MaiBotOneKey/releases/ 下载麦麦启动器(Windows/MAC);或前往 https://github.com/Mai-with-u/MaiBot/releases/ 获取最新正式版并按 https://docs.maibot.chat/manual/ 部署README 未说明
基于大语言模型的 QQ 群聊数字生命,用真人风格陪你聊天而不是一问一答
基于大语言模型的 QQ 聊天机器人,主打拟人化对话风格,追求温暖真实的互动体验而非效率,适合搭建有情感陪伴感的群聊助手。
核心能力
- 用自然口语化短句回复,避免长篇 markdown 分点
- 判断聊天气氛,在合适时机开口或保持沉默
- 在群聊中模仿他人说话风格并学习新词黑话
- 基于人格理论持续积累对你的偏好与行为记忆
- 提供插件 API 与事件系统支持扩展
容易踩的坑
- v1.4.3最新正式版2026-11-08 · 2026-11-08 11:50 UTC
主要功能
- 聊天:支持创建、复制和切换动态发言规则组,可单独关闭组内规则。
细节与修复
- 修复wait和防抖配合问题
- 模型配置:配置不完整时仍可启动并在 WebUI 修复。
- WebUI:点击侧栏顶部返回首页,Bot 切换入口移至侧栏底部。
- 记忆:修复多实例模式下记忆图片未按当前 Bot 加载的问题。
- 插件:新增聊天表情缓存前和候选表情自动注册前的钩子,允许插件跳过对应操作。
- 日志:Bot 进程控制台日志移至实例的临时目录。
- v1.4.22026-11-07 · 2026-11-07 18:45 UTC
查看更新说明
- 修复Docker启动时挂载目录问题,将会阻拦未更新的挂载路径
- 优化部分麦麦观察的显示方式
- Webui首页会显示桌宠
- v1.4.12026-11-07 · 2026-11-07 14:07 UTC
查看更新说明
- 修复一键包更新由于传入路径错误失败的问题
- 移除沙盒实验性功能。
- 修复Webui部分显示问题
- v1.4.02026-11-07 · 2026-11-07 10:30 UTC
查看更新说明
主要功能
- 多实例:允许多只麦麦挤在一个MAIBOT里,分别管理配置,数据和插件。
- WebUI焕然一新,使用了新的Webui布局,逻辑和使用更加清晰
- 麦麦答疑助手:内置了解麦麦的Agent,可以帮助答疑,下载插件和修改配置
- QQ官方适配器、微信ClawBot适配器、Telegram适配器现已内置于 MAIBOT,并优化多处问题。
- 表情包使用了新的双维度标签,优化了发送和识别能力
- 插件命令现在支持按用户和聊天设置使用权限。
- 桌宠优化了使用体验,为插件提供更多接口,且支持远程连接( Windows 和 安卓)
细节与修复
- 观察页面:支持关联查看同轮思考与回复、导入推理记录。
- 聊天:动态发言规则移除总开关、全局通配和默认兜底。
- 模型与 Git:允许配置、测试本机和内网模型服务,以及直接克隆、更新内网 Git 仓库。
- 上下文压缩优化了成功率。
- 将错别字功能迁移到内置插件
- 模型:支持自动测试思考开关。供应商 API Key 可留空并使用无鉴权模式。
- 插件运行时:移除旧 Action 组件支持。
- 日志:将回复调度、消息防抖、WebUI 正常断线及逐步关停细节移至 DEBUG。
- 稳定性:降低内存占用,修复记忆去重、无效表情缓存和退出后进程残留等问题。
- 重构了统计页面,并大幅优化了统计计算速度
- v1.3.192026-10-30 · 2026-10-30 10:36 UTC
查看更新说明
细节与修复
- 优化了插件市场的加载稳定性
- 日志:默认屏蔽列表补充
httpx2、httpcore2。 - 更新:修复更新时可能出现的网络问题。
- 插件 SDK:开放全局人设列表、当前人设查询与持久化切换能力,切换保留当前编辑并热重载。
- 桌宠:开放窗口生命周期、点击、拖动和状态变化的 Hook。SDK支持注册桌宠扩展按钮、读取状态与处理点击。
WebUI [1.9.13]
- 配置:桌宠移出实验性功能。
- 推理过程:修复手机端记录列表与详情面板重叠,未选择记录时隐藏详情空态。
- 人设:支持粘贴 JSON 导入及外部网页通过导入链接唤起预览、编辑与确认保存。
- 人设:支持保存多套全局备选人设、重命名、删除与手动切换,切换时保留当前编辑,配置保存后热重载生效。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
麦麦 MaiSaka 是一个基于大语言模型的可交互智能体。
MaiSaka 不仅仅是一个机器人,不仅仅是一个可以帮你完成任务的“有帮助的助手”,她还是一个致力于了解你,并以真实人类的风格进行交互的数字生命。她不追求完美,不追求高效,但追求亲切和真实。
MaiSaka is an interactive agent based on large language models. MaiSaka is more than just a bot, and more than a "helpful assistant" that completes tasks. She is a digital life form that tries to understand you and interact in a genuinely human style. She does not pursue perfection or efficiency above all else. She pursues warmth and authenticity.
- 没有人喜欢 GPT 的语言风格:麦麦使用了更加自然、贴合人类对话习惯的交互方式,不是长篇大论或者 markdown 格式的分点,而是或长或短的闲谈。
No one likes GPT-sounding dialogue: MaiSaka uses a more natural conversational style. Instead of long-winded markdown-heavy replies, she chats in a way that feels casual, varied, and human. - 不再是傻乎乎的一问一答:懂得在合适的时间说话,把握聊天中的气氛,在合适的时候开口,在合适的时候闭嘴。
No longer stuck in rigid Q&A: She knows when to speak, how to read the room, when to join a conversation, and when to stay quiet. - 麦麦·成为人类:在多人对话中,麦麦会模仿其他人的说话风格,还会自主理解新词或者小圈子里的黑话,不断进化。
MaiSaka becoming human: In group conversations, MaiSaka imitates how people around her speak, learns new slang and in-group language, and keeps evolving. - 永远都在更加了解你:基于心理学中人格理论,麦麦会不断积累对于你的了解,不论是你的信息、喜恶或是行为风格,她都记在心里。
Always learning more about you: Inspired by personality theory in psychology, MaiSaka gradually builds an understanding of your preferences, traits, habits, and behavior style. - 插件系统:提供强大的 API 和事件系统,拥有无限扩展可能。
Plugin system: Provides powerful APIs and an event system with virtually unlimited room for extension.
最新版本: v1.4.2
Latest Version: v1.4.2
-
发布:Release 页面展示了最新发布的正式版。 Download: Visit the Release page to get the latest version.
-
部署教程
Deployment Guide -
方便使用的麦麦启动器下载 (Windows/MAC):Maibot-OK
Launcher: Maibot OneKey
| 分支 / Branch | |
|---|---|
main | 稳定版 · STABLE |
dev | 开发版,包含开发中的新功能 · DEV |
-
麦麦文档:最全面的文档中心,了解麦麦的一切。
Documentation: The most comprehensive documentation hub for everything about MaiSaka. -
[演示视频]
| 群组 / Group | 说明 / Description |
|---|---|
| 麦麦最新交流群:995845542Mai Newest | 技术交流 / 答疑Technical discussion / Q&A |
| 麦麦脑电图:571780722MaiBrain EEG | 技术交流 / 答疑Technical discussion / Q&A |
| 麦麦大脑磁共振:766798517MaiBrain MRI | 技术交流 / 答疑Technical discussion / Q&A |
| 麦麦要当 VTBMai Wants to Be a VTuber | 技术交流 / 答疑Technical discussion / Q&A |
| 麦麦闲聊群Mai Casual Chat Group | 以闲聊为主Casual chat only, no support |
| 插件开发群:1036092828Plugin Dev Group | 插件、进阶开发与测试Advanced development and testing |
- Amaidesu:让麦麦在 B 站开播。
Let MaiSaka stream on Bilibili. - MoFox_Bot:基于 MaiCore 0.10.0 的 Fork。
An enhanced fork based on MaiCore 0.10.0.
千石可乐说:
SengokuCola:
- 这个项目最初只是为了给牛牛 bot 添加一点额外的功能,但是功能越写越多,最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的“生命体”。目的并不是为了写一个功能齐全的机器人,而是一个尽可能让人感知到真实的类人存在。
This project originally started as a few extra features for the NiuNiu bot, but it kept growing until a full rewrite became inevitable. The goal was to create a "life form" active in QQ group chats, not a feature-complete bot, but something as human-like and real-feeling as possible.- 程序的功能设计理念基于一个核心的原则:“最像而不是好”。
The core design principle is: "more lifelike, not merely better."- 如果人类真的需要一个 AI 来陪伴自己,并不是所有人都需要一个完美的,能解决所有问题的“helpful assistant”,而是一个会犯错的,拥有自己感知和想法的“生命形式”。
If people truly want AI companionship, not everyone needs a perfect "helpful assistant" that solves every problem. Some people may want a life form that can make mistakes and has its own perceptions and thoughts.
欢迎参与贡献!请先阅读 贡献指南。 Contributions are welcome. Please read the Contribution Guide first.
贡献者
Contributors
开源项目友链
Open Source Friends
- AstrBot: 优秀的LLM Agent项目。 An excellent LLM Agent project.
- Pallas-Bot: 以防你不知道牛牛又开始更新了。
特别致谢
Special Thanks
- 萨卡班甲鱼:千石可乐很喜欢的生物。
Sacabambaspis: SengokuCola's favorite creature. - 略nd:为麦麦绘制早期的精美人设。
Drew MaiSaka's beautiful early character design. - NapCat:现代化的基于 NTQQ 的 Bot 协议实现。
A modern NTQQ-based bot protocol implementation.
Star History
[!IMPORTANT] 使用前请阅读 用户协议 (EULA) 和 隐私协议。AI 生成内容请仔细甄别。
Please read the End User License Agreement (EULA) and Privacy Policy before use. Please evaluate AI-generated content carefully.
License: GPL-3.0