沐沐 MumuBot

一个基于 ReAct Agent 的赛博 QQ 群友

Powered by Eino

---

Warning

• 项目处于活跃开发阶段，配置和接口可能随时变化
• QQ 机器人存在封号风控风险，请谨慎使用
• AI 模型运行会消耗 Token，请注意用量
• 监控服务目前仅提供后端 API，暂无前端界面

✨ 特性

• 🧠 ReAct 智能体 — 通过观察-思考-行动循环自主决策是否发言
• 💬 拟人对话 — 可自定义人格、语言风格、兴趣话题，说话像真人群友
• 🧩 丰富工具集 — 发言、沉默、戳一戳、贴表情、发表情包、查群公告、网页浏览等 20+ 内置工具
• 📝 长期记忆 — MySQL + Milvus 向量数据库，支持语义检索相关记忆
• 👤 群友画像 — 自动记录群友说话风格、兴趣、活跃度、亲密度
• 🎭 情绪系统 — 心情、精力、社交意愿三维情绪状态，随对话自然变化
• 👀 多模态理解 — 支持视觉模型识别图片和视频内容
• 🖼️ 表情包系统 — 自动收集群内表情包，按描述检索并发送
• 📖 持续学习 — 主动学习群内黑话/梗和独特的表达方式，融入群文化
• ⏰ 时段策略 — 可配置不同时间段的发言活跃度
• 🔌 MCP 扩展 — 支持通过 MCP 协议接入外部工具，无限扩展能力
• 📊 监控 API — 提供 RESTful API 用于获取Bot状态、记忆和统计信息

🚀 快速开始

环境要求

依赖	说明
Go 1.24+	编译运行
MySQL	存储记忆、消息日志、群友画像
Milvus（可选）	向量数据库，启用语义记忆检索
NapCat / go-cqhttp	OneBot 11 协议实现
大语言模型 API	兼容 OpenAI 格式

安装与配置

# 1. 克隆项目
git clone https://github.com/SugarMGP/MumuBot.git
cd MumuBot

# 2. 复制配置文件并按需修改
cp config/config.example.yaml config/config.yaml
cp config/mcp.example.json config/mcp.json

# 3. 编辑配置（填入 LLM API Key、数据库信息等）
# 也可通过环境变量配置敏感信息：
#   MUMU_LLM_API_KEY        - LLM API Key
#   MUMU_AUX_LLM_API_KEY    - 辅助模型 API Key（可选，用于后台学习任务，默认复用 LLM）
#   MUMU_EMBEDDING_API_KEY  - Embedding 模型 API Key（可选，默认复用 LLM）
#   MUMU_VISION_API_KEY     - 视觉模型 API Key（可选，默认复用 LLM）
#   MUMU_MYSQL_PASSWORD     - MySQL 密码

# 4. 编译运行
go build -o mumu-bot .
./mumu-bot

🔧 MCP 工具扩展

通过编辑 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 — 灵感来源和设计参考