[保姆级教程] 把小爱音箱接入 ChatGPT，改造成你专属的语音助手～-科普

本教程会通过 1Panel 应用商店（Docker）来部署 Mi-GPT，全程操作简单，支持一键迁移/备份，还能绕开小米官方的异地登录风控。

项目开源地址：GitHub – Mi-GPT：https://github.com/idootop/mi-gpt
音箱支持列表：设备兼容性：https://github.com/idootop/mi-gpt/blob/main/docs/compatibility.md

第一步：下载 Docker Desktop

Docker Desktop 4.39.0 原版 https://github.com/asxez/DockerDesktop-CN/releases/download/4.39.0/DockerDesktop-4.39.0-Windows-arm.exe
Docker Desktop 4.39.0 汉化教程：https://github.com/asxez/DockerDesktop-CN?tab=readme-ov-file#docker-desktop汉化包
安装过程中一路点确定就行

耐心等安装完成，然后重启电脑

打开 Docker Desktop，一路跳过初始引导，出现主界面就说明安装成功了。

第二步：本地跑一遍 Mi-GPT，提取 JSON 文件

小米账号异地登录经常要反复收验证码，容易陷入死循环，所以建议先在本地登录，再把登录信息转移到服务器上。

拉取 Mi-GPT 镜像

打开 Docker Desktop，进入“容器”这一栏。
在顶部搜索框里输入 Mi-GPT，找到 idootop/mi-gpt，拉取 latest 版本就行。

4. 运行容器，配置好下面这几个环境变量：

OPENAI_MODEL=e.g. gpt-4o-mini
OPENAI_API_KEY=YOUR_API_KEY
OPENAI_BASE_URL=YOUR_BASE_URL

所有基于 OpenAI SDK 的 API 接口都能用，注意 base_url 截止到 /v1，且末尾不要多余的 /❗❗❗

点“Run”运行容器，这时候可能会报错，是因为还没配置登录信息。

配置登录信息

下载示例配置文件 .migpt.example.js：https://github.com/idootop/mi-gpt/blob/main/.migpt.example.js
把文件改名成 .migpt.js（注意文件名前面那个 。 不能漏）。
用任意编辑器打开 .migpt.js，找到 93-98 行，把小米账号和小爱音箱的 DID 信息填进去。
改完之后保存在本地就行。

把登录文件复制进容器

右键点开始菜单，打开 PowerShell（管理员），执行下面这条命令（把 本机路径 和 Docker ID 换成自己的，Docker ID 从图里红圈的地方复制）：
```
docker cp "本机的.migpt.js存放路径" Docker_ID:/app/.migpt.js
```

举个例子：

docker cp "E:/mi-gpt/.migpt.js" d92444226e00:/app/.migpt.js

在 Docker Desktop 里找到 mi-gpt 容器，点 Restart 重启它。
等它启动完，日志里出现 ✅ 服务已启动... 就说明跑起来了。
执行下面这条命令，把 .mi.json 文件提取出来：
```
docker cp Docker_ID:/app/.mi.json 存放.mi.json的本机路径
```
出现 Successfully copied 提示就说明成功了。

这个文件是长期有效的登录凭证，只要不换音箱或者账号，就不用重新生成📌

第三步：安装 1Panel 第三方应用商店

如果还没装 1Panel，先用下面这个脚本装一下📌📌📌
安装过程全程都有很详细的中文提示，照着实际情况填就行

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

在服务器上执行下面的命令，安装 1Panel 第三方应用商店：

git clone -b localApps https://github.com/okxlin/appstore /opt/1panel/resource/apps/local/appstore-localApps
cp -rf /opt/1panel/resource/apps/local/appstore-localApps/apps/* /opt/1panel/resource/apps/local/

把 `.migpt.js` 和 `.mi.json` 迁移到服务器

传文件的时候 注意 1Panel 或者 SFTP 可能会把文件名前的 。 弄丢，记得检查一下、手动补上📌
进入 1Panel → 应用商店，点右上角的 更新应用列表，搜 mi-gpt 装上。

配置 mi-gpt

在安装界面里把 OpenAI API 信息填好。

注意：模型和 API 信息别照抄，根据你自己用的 API 情况来填，没接触过 API 的可以看文章末尾的推荐
2. 勾选“编辑 compose 文件”，把 volumes 改一下，比如：

- /opt/mi-gpt/.migpt.js:/app/.migpt.js
- /opt/mi-gpt/.mi.json:/app/.mi.json

点确认，成功之后就能正常运行了。

要是想调 TTS 参数或者自定义提示词，编辑 /opt/.migpt.js 就行，改完在 1Panel 应用商店点“重建”生效📌

第四步：API 推荐

如果你没用过 ChatGPT API，可以试试 OhMyGPT：https://www.ohmygpt.com?aff=lT1zCQwh，每天有 3000 代币的免费额度

推荐用 gpt-4o-web-rev 这个模型，性价比比较高

gpt-4o-web-rev 是官网的逆向版本，调用 556 次大概消耗 1 元人民币（36000 代币），很适合用在语音对话场景