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 作为演示，阿里云百炼的新用户登录即有每个模型 100 万免费 tokens:
登录好以后，进入到密钥管理页面：
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 音色列表,如下为我在 gitee 中开源的一个小页面，可以自行部署填写APP ID和Access Token即可：
https://gitee.com/jun-wan/volcano-engine-tts-sound-list
4 登录问题修复及效果演示
4.1 登录问题修复
配置完成后，点击页面上的启动按钮，即可启动：
然后可以回到 cmd 终端，输入如下命令查看 migpt-server 运行日志（用户查看对话）：
docker logs -f migpt-server
可以看到控制台提示了小米异地登录安全验证机制，这个问题即使访问链接登录了也不好使，如下为我整理出来的解决方法步骤如下：
1. 进入容器内部，进入 migptgui 容器的交互式 shell
2. 创建配置文件目录，创建 .migptgui/default 目录
3. 登录小米账号，在浏览器中访问小米账户获取授权或信息
4. 创建并写入 .mi.json 文件，在容器内创建文件并写入 Mina 和 Miiot 的 passToken
5. 验证文件是否创建成功，查看 .mi.json 是否存在并显示内容
6. 退出容器内部
我们按照步骤执行，首先需要进入到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 智能助手，快去和它聊聊天吧！
6 下载安装 cpolar
到这里，MiGPT GUI 已经在本地跑起来了，但问题也随之而来——每次想换个人设、调整 TTS 音色、或者切换大模型 API，都得守在电脑前操作。有了 cpolar 内网穿透，这些烦恼就迎刃而解了。只需简单配置，就能随时随地通过公网访问 MiGPT GUI 管理面板，远程调参、切换模型、更新人设，统统不在话下。
6.1 什么是 cpolar?
- cpolar 是一款内网穿透工具，可以将你在局域网内运行的服务（如本地 Web 服务器、SSH、远程桌面等）通过一条安全加密的中间隧道映射至公网，让外部设备无需配置路由器即可访问。
- 广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台，并提供一键安装脚本方便部署。
6.2 下载 cpolar
打开 cpolar 官网的下载页面：
点击立即下载按钮，下载 cpolar 的安装包：
下来下来是一个压缩包，解压后执行目录种的应用程序，一路默认安装即可，安装完成后，打开 cmd 窗口输入如下命令确认安装：
cpolar version
出现如上版本即代表安装成功!
6.3 注册及登录 cpolar web ui 管理界面
访问 cpolar 官网，点击免费注册按钮，进行账号注册
进入到如下的注册页面进行账号注册：
注册完成后，在浏览器中输入如下地址访问 web ui 管理界面：
http://127.0.0.1:9200
输入刚才注册好的 cpolar 账号登录即可进入后台页面：
7 穿透 MiGPT GUI 实现公网访问
7.1 随机域名方式 (免费方案)
随机域名方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费的，如果您有一定的预算，可以查看大纲 7.2 的固定域名方式，且访问更稳定。
点击左侧菜单栏的隧道管理，展开进入隧道列表页面，页面下默认会有 2 个隧道：
- remoteDesktop 隧道，指向 3389 端口，tcp 协议
- website 隧道，指向 8080 端口，http 协议（http 协议默认会生成 2 个公网地址，一个是 http，另一个 https，免去配置 ssl 证书的繁琐步骤）
点击编辑 website 的隧道，修改成我们 MiGPT GUI 需要的信息：
接着，点击左侧菜单的状态菜单，接着点击在线隧道列表菜单按钮，可以看到有 2 个migpt的隧道，一个为 http 协议，另一个为 https 协议：
注意：每个用户创建的隧道显示的公网地址都不一样！
接下来在浏览器中访问migpt隧道生成的公网地址（http 和 https 皆可），这里以 https 为例：
可以看到成功访问啦!
7.2 固定域名方式
通过前面的配置，我们已经成功实现了MiGPT GUI的远程访问，但免费随机域名方案的局限性也逐渐显现：每24 小时左右自动更换域名地址，意味着你需要频繁更新书签、重新分享链接，甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生，能够让你拥有一个永久不变的专属地址。
首先，进入官网的预留页面：
https://dashboard.cpolar.com/reserved
选择预留菜单，即可看到保留二级子域名项，填写其中的地区、名称、描述（可不填）项，然后点击保留按钮，操作步骤图如下：
列表中显示了一条已保留的二级子域名记录：
- 地区：显示为
China Top。 - 二级域名：显示为
migpt。
注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主
接着，进入侧边菜单栏的隧道管理下的隧道列表，可以看到名为migpt的隧道，点击编辑按钮进入编辑页面：
修改域名类型为二级子域名，然后填写前面配置好的子域名，点击更新按钮：
接着，来到状态菜单下的在线隧道列表可以看到隧道名称为migpt的公网地址已经变更为二级子域名 + 固定域名主体及后缀的形式了：
这里以 https 协议做访问测试：
访问成功！这样一来，你就拥有了一个永久不变的专属域名，再也不用担心 24 小时域名更换的问题啦！
总结
MiGPT GUI 丰富了小爱音箱的交互体验，搭配 cpolar 内网穿透后，彻底摆脱局域网束缚，远程管理更便捷。简单配置就能让小爱音箱拥有智能对话和个性化人设，日常使用省心又实用。
