跳到主要内容MiGPT GUI 部署小爱音箱接入大模型配置 | 极客日志Shell / BashAI
MiGPT GUI 部署小爱音箱接入大模型配置
MiGPT GUI 是一款图形化工具,可将小爱音箱接入 DeepSeek 等大模型。通过 Docker 一键部署服务,配置小米账号 ID 及设备名称,设置阿里云百炼 API Key 接入 AI,并配置火山引擎豆包 TTS 实现语音合成。针对异地登录问题,需进入容器创建配置文件写入 passToken。支持自定义人设与连续对话,提升交互体验。
松间照月15 浏览 
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 容器状态:
可以看到 status(状态) 显示为 UP,端口为 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:
3.2 配置接入 AI 大模型
这里以 阿里云百炼 的 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 为例,填写:
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
ls -la /root/.migptgui/default/
4.2 效果演示
修复登录问题后,输入如下命令启动容器(由于前面账号登录问题,容器其实停止了):
docker start migpt-server
然后可以回到 cmd 终端,输入如下命令再次查看 migpt-server 运行日志(用户对话查看):
docker logs -f migpt-server
可以看到,现在服务成功启动了,在前面可以看到单次对话调用 AI 的关键词配置的为 请、你、傻妞:
可以看到成功回答了,而且使用的我们配置的音色进行回答的!个别音箱还支持连续对话,可以通过关键词召唤:
可以看到成功的都调用 AI 进行回复啦。这样你的小爱音箱就已经支持 AI 啦!
5 设置人设
前面我们已经完美的配置好了小爱音箱接入大模型 DeepSeekV3.2,并且配置上了 豆包的音色,本期将带你更换默认人设 傻妞。
可以看到已经插入了默认的模板,我们需要修改成自己喜欢的角色人物,比如这里以 猫娘 为例(为了省事,直接用 AI 生成了一个人设):
将 人设 覆盖之前的模板,然后重新点击 启动 按钮即可:
可以看到,我们设置的人设已经生效了!现在你的小爱音箱已经变身为一个具备个性化人设的 AI 智能助手,快去和它聊聊天吧!
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- 随机西班牙地址生成器
随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online