木木机器人

环境要求

2. 安装前端依赖并构建后台资源

npm ci npm run build

🚀 快速开始

4. 编译

go build -o mumu-bot . ```

使用发布包

GitHub Release 提供 Linux、Windows、macOS 的打包产物。归档内包含：

• 可执行文件
• config/config.yaml 示例配置
• config/persona.prompt 人格提示词模板
• config/mcp.json 示例配置
• README.md 和 LICENSE

运行发布包时不需要额外部署前端静态文件，管理后台所需资源已经内嵌进二进制；如果要调整静态人格提示词，可直接编辑归档里的 config/persona.prompt。

配置与启动

如果你使用的是 GitHub Release 里的打包归档，可直接编辑归档自带的 config/config.yaml、config/persona.prompt 和 config/mcp.json，不用再执行下面的复制命令。

```bash

3. 启动

./mumu-bot ```

默认情况下服务监听 8080 端口，可在配置中修改。

访问服务的 /admin 路径进入管理后台。未设置后台密钥时，后台会保持关闭状态。

1. 复制配置文件并按需修改

cp config/config.example.yaml config/config.yaml cp config/mcp.example.json config/mcp.json

2. 编辑配置（填入模型、数据库、OneBot 等信息）

也可通过环境变量配置敏感信息：

静态人格提示词模板位于 config/persona.prompt

persona.name、persona.qq、persona.alias_names、persona.interests 仍在 config/config.yaml 中配置

MUMU_MODEL_HIGH_API_KEY - 高档模型 API Key

MUMU_MODEL_MID_API_KEY - 中档模型 API Key

MUMU_MODEL_LOW_API_KEY - 轻量模型 API Key

MUMU_EMBEDDING_API_KEY - Embedding 模型 API Key

MUMU_VISION_API_KEY - 视觉模型 API Key

🔧 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": []
        }
    ]
}