快速上手

更新: 2026/09/09字数: 0 字时长: 1 分钟

欢迎来到 MaiBot 用户手册。MaiBot（昵称「麦麦」）是一个基于大语言模型的聊天机器人框架——通过适配器它可以接入 QQ、邮件、iMessage 等平台，在群聊里像真人一样聊天、记忆、学习、使用工具。本手册从零开始，带你完成安装、配置、连接平台，并逐步掌握它的全部功能。

系统要求

一台能联网的电脑（Windows 10+ / Linux / macOS），至少 2GB 可用内存，以及一个 LLM 的 API Key。硬件门槛不高，普通家用电脑就能跑。

🚀 快速上手

从零到能聊天，只需要四步。每步约 1~2 分钟，跟着下面的卡片走就行。

Windows 用户推荐使用一键包——无需安装命令行工具，双击安装后自动配置 Python 环境并弹出配置向导。Linux、macOS 或想用容器的话也有对应的方案。

启动后，用浏览器访问 http://localhost:8001，把首次启动时终端打印的登录 Token 粘进去即可。WebUI 是管理 MaiBot 的图形界面，后续配置基本都在这里完成。

在 WebUI 的模型配置里填写你的 API 服务商地址和 Key，并选择要用的模型。至少要有一个 LLM 模型，麦麦才能开口说话。

以最常用的 QQ 为例：装好 NapCat 并开启正向 WebSocket，然后在 WebUI 的插件市场安装「NapCat 适配器」并启用，麦麦就能进群聊天了。

跑起来之后，按需查阅下面的分区，把麦麦调教成你想要的样子。

人格、昵称、聊天风格、记忆开关……所有配置文件都能在 WebUI 里改，也能直接编辑 TOML。

除了 QQ，麦麦还可以接入邮件、iMessage 等平台。查看不同适配器的接入方式和维护状态。