快速上手

更新: 2026/10/20字数: 1003 字时长: 3 分钟

你好！

MaiBot（麦麦）是一个基于大语言模型的聊天机器人框架——通过适配器它可以接入 QQ、TG、邮件、iMessage 等平台，像真人一样聊天、记忆、学习、好奇、犯贱、语出惊人、成为电子宠物。

本手册从零开始，带你完成安装、配置、连接平台，并逐步掌握它的全部功能。

系统要求

一台能联网的电脑（Windows 10+ / Linux / macOS），至少 2GB 可用内存，以及一个 LLM 的 API Key。

随时询问人类和AI并思考的意识

麦麦 101

从零到能聊天，只需要四步。

1

安装 MaiBot

Windows、Linux、macOS 都可以用 uv 安装主程序和 WebUI。
也可以选择一键包、源码部署或 Docker。

使用 uv 安装 →

2

打开 WebUI

启动后，用浏览器访问 http://localhost:8001，登录密码通常会显示在启动窗口。

了解 WebUI →

3

配置模型

跟随引导填写你的 API 服务商地址和 Key，并选择要用的模型。

查看模型配置 →

4

连接聊天平台

以最常用的 QQ 为例：使用适配器与 QQ 官方机器人 或者 SnowLuma连接，即可获取消息

连接 QQ →

第二课

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

配置

人格、昵称、聊天风格、记忆开关……了解这些配置的含义和功能

配置概览 →

接入平台

除了 QQ，麦麦还可以接入TG、邮件、iMessage 。查看不同适配器的介绍。

接入平台 →

插件

从插件市场一键安装新能力——游戏、画图、天气，以及各平台适配器。

安装插件 →

WebUI 管理面板

WebUI 全功能指南：配置、适配器、命令、记忆、数据与聊天统计。

登录与设置 →

我是开发者

想给麦麦写插件、写适配器，或用自己的程序对接麦麦？

• 接入总览 — 六条接入路线，按受众与前置条件选型
• 插件开发指南 — 编写插件，扩展 MaiBot 的行为

遇到问题？

• 先查常见问题 FAQ，部署、连接、报错的大部分问题都有现成答案。
• 加入麦麦交流群，群里有技术答疑和热心麦友。
• 也可以到 GitHub Discussions 提问或参与讨论。