木木机器人

环境要求

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

bun install --frozen-lockfile bun run build

🚀 快速开始

Docker Compose

Compose 会一并启动 MumuBot、PostgreSQL/pgvector 和 NapCat：

```bash cp .env.example .env

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

数据库使用 PostgreSQL，且需要安装 [pgvector](https://github.com/pgvector/pgvector)。

应用启动时会尝试执行下面两条语句启用扩展，再自动创建和校验数据结构。权限不足时可由管理员预先执行下面的语句。

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

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

填写 .env 中的数据库、后台和模型配置

docker compose up -d ```

Compose 会直接拉取 GHCR 上的 latest 镜像。首次启动时，容器会在配置目录中补齐缺失的 config.yaml、persona.prompt 和 mcp.json，已有文件不会被覆盖。

编辑生成的配置文件后，重启服务使其生效。随后访问 http://localhost:6099/webui 进入 NapCat 管理后台登录 QQ 即可。

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.alias_names、persona.interests 仍在 config/config.yaml 中配置

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 - 视觉模型完整端点

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