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.

v1.4.3发布于 2026-11-08 11:50 UTC6,966star +59 / 7 天752fork同步于 2026-11-10 17:34 UTC

怎么上手

由 README 提炼,执行前请确认
从 https://github.com/Mai-with-u/MaiBotOneKey/releases/ 下载麦麦启动器(Windows/MAC);或前往 https://github.com/Mai-with-u/MaiBot/releases/ 获取最新正式版并按 https://docs.maibot.chat/manual/ 部署
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于大语言模型的 QQ 群聊数字生命,用真人风格陪你聊天而不是一问一答

基于大语言模型的 QQ 聊天机器人,主打拟人化对话风格,追求温暖真实的互动体验而非效率,适合搭建有情感陪伴感的群聊助手。

核心能力

  • 用自然口语化短句回复,避免长篇 markdown 分点
  • 判断聊天气氛,在合适时机开口或保持沉默
  • 在群聊中模仿他人说话风格并学习新词黑话
  • 基于人格理论持续积累对你的偏好与行为记忆
  • 提供插件 API 与事件系统支持扩展

容易踩的坑

需要 Python 3.12+ 环境;需自行准备大语言模型接入配置;README 未给出默认端口等运行细节,需查部署教程

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.4.3
  1. v1.4.3最新正式版2026-11-08 · 2026-11-08 11:50 UTC

    主要功能

    • 聊天:支持创建、复制和切换动态发言规则组,可单独关闭组内规则。

    细节与修复

    • 修复wait和防抖配合问题
    • 模型配置:配置不完整时仍可启动并在 WebUI 修复。
    • WebUI:点击侧栏顶部返回首页,Bot 切换入口移至侧栏底部。
    • 记忆:修复多实例模式下记忆图片未按当前 Bot 加载的问题。
    • 插件:新增聊天表情缓存前和候选表情自动注册前的钩子,允许插件跳过对应操作。
    • 日志:Bot 进程控制台日志移至实例的临时目录。
  2. v1.4.22026-11-07 · 2026-11-07 18:45 UTC
    查看更新说明
    • 修复Docker启动时挂载目录问题,将会阻拦未更新的挂载路径
    • 优化部分麦麦观察的显示方式
    • Webui首页会显示桌宠
  3. v1.4.12026-11-07 · 2026-11-07 14:07 UTC
    查看更新说明
    • 修复一键包更新由于传入路径错误失败的问题
    • 移除沙盒实验性功能。
    • 修复Webui部分显示问题
  4. 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。
    • 稳定性:降低内存占用,修复记忆去重、无效表情缓存和退出后进程残留等问题。
    • 重构了统计页面,并大幅优化了统计计算速度
  5. v1.3.192026-10-30 · 2026-10-30 10:36 UTC
    查看更新说明

    细节与修复

    • 优化了插件市场的加载稳定性
    • 日志:默认屏蔽列表补充 httpx2、httpcore2。
    • 更新:修复更新时可能出现的网络问题。
    • 插件 SDK:开放全局人设列表、当前人设查询与持久化切换能力,切换保留当前编辑并热重载。
    • 桌宠:开放窗口生命周期、点击、拖动和状态变化的 Hook。SDK支持注册桌宠扩展按钮、读取状态与处理点击。

    WebUI [1.9.13]

    • 配置:桌宠移出实验性功能。
    • 推理过程:修复手机端记录列表与详情面板重叠,未选择记录时隐藏详情空态。
    • 人设:支持粘贴 JSON 导入及外部网页通过导入链接唤起预览、编辑与确认保存。
    • 人设:支持保存多套全局备选人设、重命名、删除与手动切换,切换时保留当前编辑,配置保存后热重载生效。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    麦麦 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