一个会聊天、会记事、会融入群文化的赛博 QQ 群友
中文 · English
Warning
- 项目仍在快速迭代，配置项和运行行为可能随版本调整
- QQ 机器人存在账号风控风险，请谨慎使用
- AI 模型调用会消耗 Token，请按需控制用量
沐沐是一个运行在 QQ 群里的群友智能体。跟常见的问答机器人不同，沐沐会自己判断什么时候该说话、什么时候闭嘴，会记住群里聊过的事，会学群里的黑话和梗，还会随着聊天慢慢建立对每个群友的了解。
简单说：它试着像一个真实的人一样待在群里，而不是一个随叫随到的工具。
本项目具有以下核心特性：
- 🧠 ReAct 智能体 — 通过观察、思考、行动循环，自主判断是否接话、查询信息或保持沉默
- 💬 拟人对话 — 可自定义人格、语言风格和兴趣话题，说话更接近真实群友
- 🧵 话题工作记忆 — 持续跟踪当前话题、摘要、参与者与未完事项，并可召回已归档话题
- 🧩 丰富工具集 — 19 个内置工具覆盖发言、沉默、表达方式、戳一戳、贴表情、发表情包、查群信息和网页浏览，并可通过 MCP 扩展
- 📝 长期记忆 — 基于 PostgreSQL、pgvector 与 pg_trgm 保存和检索事实、经历、偏好、约束与目标
- 👤 群友画像 — 记录每个人有明确消息证据的别名、表达习惯、兴趣和常用语
- 🎭 情绪系统 — 心情、精力、社交意愿三维情绪状态随对话自然变化，影响说话方式和活跃度
- 👀 多模态理解 — 支持视觉模型识别图片和视频内容
- 🖼️ 表情包系统 — 自动收集群内表情包，由智能体自行决策使用
- 📖 持续学习 — 主动学习群内聊天氛围和常用梗，沉淀为可审核的群文化资料
- ⏰ 时段策略 — 可配置不同时间段的发言活跃度，同时支持防话痨动态限流
- 🔌 MCP 扩展 — 支持通过 MCP 协议接入外部工具，无限扩展能力
- 🖥️ 管理后台 — 查看总览、审核学习结果、管理话题/记忆/表情包，并浏览群友画像
- 📊 监控接口 — 提供健康检查与状态接口，方便接入部署和运维流程
| 依赖 | 说明 |
|---|---|
| Go 1.26.5+ | 编译运行 |
| Node.js 22+ | 构建前端资源（仅从源码构建时需要） |
| PostgreSQL + pgvector | 存储消息、记忆、话题、群文化和向量 |
| NapCat | OneBot 11 协议实现 |
| 大语言模型 API | 兼容 OpenAI 格式；需支持工具调用与结构化输出 |
Compose 会一并启动 MumuBot、PostgreSQL/pgvector 和 NapCat：
cp .env.example .env
# 填写 .env 中的数据库、后台和模型配置
docker compose up -dCompose 会直接拉取 GHCR 上的 latest 镜像。首次启动时，容器会在配置目录中补齐缺失的 config.yaml、persona.prompt 和 mcp.json，已有文件不会被覆盖。
编辑生成的配置文件后，重启服务使其生效。随后访问 http://localhost:6099/webui 进入 NapCat 管理后台登录 QQ 即可。
GitHub Release 提供 Linux、Windows、macOS 的打包产物。归档内包含：
- 可执行文件
config/config.yaml示例配置config/persona.prompt人格提示词模板config/mcp.json示例配置README.md和LICENSE
运行发布包时不需要额外部署前端静态文件，管理后台所需资源已经内嵌进二进制；如果要调整静态人格提示词，可直接编辑归档里的 config/persona.prompt。
# 1. 克隆项目
git clone https://github.com/SugarMGP/MumuBot.git
cd MumuBot
# 2. 安装前端依赖并构建后台资源
bun install --frozen-lockfile
bun run build
# 3. 生成 templ 视图代码
go run github.com/a-h/templ/cmd/templ@latest generate ./internal/web/views
# 4. 编译
go build -o mumu-bot .如果你使用的是 GitHub Release 里的打包归档，可直接编辑归档自带的 config/config.yaml、config/persona.prompt 和 config/mcp.json，不用再执行下面的复制命令。
# 1. 复制配置文件并按需修改
cp config/config.example.yaml config/config.yaml
cp config/mcp.example.json config/mcp.json
# 2. 编辑配置（填入模型、数据库、OneBot 等信息）
# 也可通过环境变量配置敏感信息：
# MUMU_MODEL_HIGH_BASE_URL / API_KEY / MODEL - 高档模型完整端点
# MUMU_MODEL_LOW_BASE_URL / API_KEY / MODEL - 轻量模型完整端点
# MUMU_EMBEDDING_BASE_URL / API_KEY / MODEL - Embedding 模型完整端点
# MUMU_VISION_BASE_URL / API_KEY / MODEL - 视觉模型完整端点
# MUMU_ONEBOT_TOKEN - OneBot 访问令牌
# MUMU_DATABASE_DSN - PostgreSQL 连接串
# 静态人格提示词模板位于 config/persona.prompt
# persona.name、persona.alias_names、persona.interests 仍在 config/config.yaml 中配置
# 机器人 QQ 会在连接 OneBot 后自动识别；interests 只作为人格背景，不改变消息触发概率
# 3. 启动
./mumu-bot数据库使用 PostgreSQL，且需要安装 pgvector。
应用启动时会尝试执行下面两条语句启用扩展，再自动创建和校验数据结构。权限不足时可由管理员预先执行下面的语句。
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS pg_trgm;默认情况下服务监听 7468 端口，可在配置中修改。
访问服务的 /admin 路径进入管理后台。未设置后台密钥时，后台会保持关闭状态。
config/persona.prompt 是默认的人格提示词模板文件，用来约束沐沐的整体人设、说话节奏和回复风格。你可以按自己的群聊场景直接调整这份模板，再结合实际对话效果反复测试。
如果你测出了更自然、更稳定、也更好用的 prompt，欢迎通过 Issue 分享使用场景和效果，或直接提交 Pull Request 一起完善这份模板。
通过编辑 config/mcp.json 接入外部 MCP 服务器，支持 SSE 和 Stdio 两种传输方式：
{
"servers": [
{
"name": "example-mcp-server-sse",
"enabled": false,
"type": "sse",
"url": "http://localhost:3333/sse",
"tool_name_list": [],
"custom_headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
},
{
"name": "example-mcp-server-stdio",
"enabled": false,
"type": "stdio",
"command": "",
"args": [],
"env": []
}
]
}欢迎任何形式的贡献！ 无论是提交 Bug 报告、功能建议，还是直接提交代码，我们都非常感谢。
- cloudwego/eino — 字节跳动开源 AI Agent 框架
- NapNeko/NapCatQQ — 现代化 OneBot 协议实现
- Mai-with-u/MaiBot — 灵感来源和设计参考