MiGPT GUI 是一款专为小爱音箱打造的图形化工具，核心功能是将小爱音箱接入 DeepSeek V3.2 等大模型，支持自定义人设、切换豆包 TTS 音色，同时兼容 Windows、Mac、Linux 多系统，零基础也能通过 Docker 一键部署，适配小爱音箱 Pro、mini 等多款设备。
使用 MiGPT GUI 时，配置小米账号要准确填写设备 ID（需和米家 APP 一致），AI 大模型 API 密钥和 TTS 参数填写错误会导致功能失效，且首次部署后建议先测试语音配置，避免后续使用中出现音色异常的情况。
1 什么是 MiGPT GUI？
MiGPT GUI 是一个图形化工具，旨在让用户 轻松将小爱音箱接入人工智能大模型。它通过可视化界面简化了配置和部署流程，即使没有深厚的编程基础，也能快速完成以下操作：
- 接入 MiGPT 大模型，让小爱音箱获得更智能的对话能力；
- 自定义人设和对话风格，让音箱的回答更符合个人需求；
- 支持 TTS（文本转语音），实现自然语音输出；
- 安全快速部署，可在本地或 Docker 环境运行；
- 设备兼容性一目了然：
| 支持类型 | 设备 1 | 设备 2 | 设备 3 | 设备 4 | 设备 5 | 设备 6 |
|---|---|---|---|---|---|---|
| ✅ 支持连续对话 | 小爱音箱 Pro | 小爱音箱 mini | 小爱音箱 Play（2019） | 万能遥控版 | 小米 AI 音箱（1&2 代） | 小爱智能家庭屏 10 |
| ⚠️ 不支持连续对话 | 小爱音箱 | 小爱音箱 Play | Play 增强版 | 智能家庭屏 6 | Redmi 触屏音箱 Pro 8 | 小爱音箱 Art |
| ❌ 无法运行 | 小米小爱音箱 HD | 小爱蓝牙音箱随身版 | - | - | - | - |
简单来说，MiGPT GUI 就是小爱音箱接入大模型的'可视化桥梁'，把复杂的配置和接口调用都封装在图形界面里。
2 Docker 一键部署 migpt-server
本教程将以 Windows 系统上的 Docker 部署 migpt-server 作为演示。首先，电脑按 Win+R 键，输入 cmd 回车，打开命令提示符窗口。然后输入如下命令一键部署 migpt-server 服务：
docker run -d --name migpt-server -p36592:36592 lmk123/migpt-server
执行完成后，可以使用如下命令查看 Docker 容器状态：
docker ps
可以看到 status(状态) 显示为 UP，端口为 36592，代表正常运行。接着，浏览器访问如下地址：
http://localhost:36592
可以看到如下页面：
这样，你就成功部署好了 migpt-server。
3 配置 migpt-server
3.1 配置小米账号及小爱设备
回到 MiGPT 控制面板 页面，下拉找到音箱部分，选择你的 音箱型号：
我这里是 小爱音箱 Pro，所以选择了它。接着小米账号 ID 部分，访问如下地址登录你的小米账号：
https://account.xiaomi.com/fe/service/account/profile
将 小米 ID 复制下来，填写到 MiGPT 控制面板 中的 小米账号 ID 列中，以及填写好你的小米账号密码：
接着，设备 ID 这儿，可以访问你的 米家 APP 中显示的名称，注意空格也要正确填写，比如我的显示为 Xiaomi 智能音箱 Pro：
就将该名字填写至设备 ID 这一列中：
3.2 配置接入 AI 大模型
阿里云百炼官网：https://bailian.console.aliyun.com/#/home
这里以 阿里云百炼 的 API 作为演示。登录好以后，进入到密钥管理页面：
https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.60907980OAftBf&tab=model#/api-key
点击页面上的创建 API-KEY 按钮，选择你的 归属账号，然后点击 确认：
确认后即可创建成功，点击页面上的 API-Key 列 的复制按钮即可复制你的 Api-Key 密钥：
复制好以后回到 MiGPT 控制面板 页面，在接口地址中填写如下链接：
https://dashscope.aliyuncs.com/compatible-mode/v1
密钥部分填写刚才复制下来的 Api-Key 密钥，模型部分这里以 DeepSeek 最新的 V3.2 为例，填写：
deepseek-v3.2
参考如下图：
这样就配置好，接入好 AI 了！
3.3 配置语音 TTS 服务
前面已经配置好了 AI 服务，接下来我们来配置一下语音服务，让你的小爱同学能够使用其他的音色来回答你的问题！
滚动到下方的语音服务项：
可以看到 TTS 引擎显示为 默认，默认为小爱同学音色，点击可以切换引擎，这里以豆包为例：
切换后，会有 4 个参数，首先是 对外地址，对外地址需要填写 局域网地址 或者部署在公网填写 公网地址 (比如我的电脑局域网 IP 为)：
http://192.168.50.149:36592
接下来是 APP ID 和 Access Token，首先需要登录 火山引擎控制台：
https://console.volcengine.com/home
登录上以后，点击左上角 3 条杠，然后搜索 语音合成，点击 豆包语音 进入：
进入以后，点击 创建应用：
然后勾选上语音合成，点击确定即可：
接着在侧边栏的 语音合成 里面，就能看到你的 APP ID 和 Access Token 了：
将其粘贴至 MiGPT 控制面板 中即可，然后点击 测试语音配置，就可以试听一下是否配置成功了，默认是使用的 灿灿 音色：
如果想要换其他音色，可以参考 火山引擎 TTS 音色列表。
4 登录问题修复及效果演示
4.1 登录问题修复
配置完成后，点击页面上的启动按钮，即可启动：
然后可以回到 cmd 终端，输入如下命令查看 migpt-server 运行日志（用户查看对话）：
docker logs -f migpt-server
可以看到控制台提示了 小米异地登录安全验证机制，这个问题即使访问链接登录了也不好使，解决方法步骤如下：
- 进入容器内部，进入 migptgui 容器的交互式 shell
- 创建配置文件目录，创建 .migptgui/default 目录
- 登录小米账号，在浏览器中访问小米账户获取授权或信息
- 创建并写入 .mi.json 文件，在容器内创建文件并写入 Mina 和 Miiot 的 passToken
- 验证文件是否创建成功，查看 .mi.json 是否存在并显示内容
- 退出容器内部
我们按照步骤执行，首先需要进入到 migpt-server 的容器内部，执行命令 (记得用 ctrl + c 停止之前查看日志的占用)：
docker exec -it migpt-server /bin/sh
接着，在容器内创建配置文件目录，执行如下命令：
mkdir -p /root/.migptgui/default
然后登录小米账号官网，获取到你的 passToken：
https://account.xiaomi.com
操作步骤如下：
获取到 passToken 后，在 docker 容器内部执行如下命令 (注意替换上你的 passToken)：
cat > /root/.migptgui/default/.mi.json <<'EOF'
{
"mina": {
"pass": {
"passToken": "你的小米账号 Token"
}
},
"miiot": {
"pass": {
"passToken": "你的小米账号 Token"
}
}
}
EOF
然后验证是否成功创建 .mi.json 文件：
ls -la /root/.migptgui/default/
成功，执行如下命令退出容器即可：
exit
4.2 效果演示
修复登录问题后，输入如下命令启动容器（由于前面账号登录问题，容器其实停止了）：
docker start migpt-server
再次点击页面上的启动按钮，即可启动：
然后可以回到 cmd 终端，输入如下命令再次查看 migpt-server 运行日志（用户对话查看）：
docker logs -f migpt-server
可以看到，现在服务成功启动了，在前面可以看到单次对话调用 AI 的关键词配置的为 请、你、傻妞：
这里询问一下，如：
小爱同学，你是谁？
可以看到成功回答了，而且使用的我们配置的音色进行回答的！个别音箱还支持连续对话，可以通过关键词召唤：
这里使用如下指令唤醒连续对话：
召唤 为什么地球是方的？那为什么地球是圆的？
可以看到成功的都调用 AI 进行回复啦。这样你的小爱音箱就已经支持 AI 啦！
5 设置人设
前面我们已经完美的配置好了小爱音箱接入大模型 DeepSeekV3.2,并且配置上了 豆包的音色，本期将带你更换默认人设 傻妞。
首先，滚动到最顶部，可以看到如下：
我们点击 自定义 按钮，然后点击写入默认模板：
可以看到已经插入了默认的模板，我们需要修改成自己喜欢的角色人物，比如这里以 猫娘 为例（为了省事，直接用 AI 生成了一个人设）：
将 人设 覆盖之前的模板，然后重新点击 启动 按钮即可：
让我们询问一下小爱同学看看：
小爱同学，你是谁？
可以看到，我们设置的人设已经生效了！现在你的小爱音箱已经变身为一个具备个性化人设的 AI 智能助手，快去和它聊聊天吧！