企业官网建设流程全解析

如何让小爱音箱变成 ChatGPT 语音助手：完整 MiGPT 部署与配置

【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt

MiGPT 是一个把小爱音箱接入 ChatGPT、豆包等大模型的开源项目。它把你说的话交给大模型，再把回答从音箱里念出来。这篇文章按 Docker 和源码两条路线，把部署过程完整走一遍，命令都可以直接照抄。

接入大模型后 MiGPT 给小爱音箱带来了什么

你问小爱"天空为什么是蓝色的"，以前只能得到固定话术。接入大模型后，它能按你的问题即时生成回答。常用的几项能力：

• 流式响应：回答边生成边播报，不用等全文输出完。
• 关键词唤醒：说"小爱同学，召唤傻妞"进入 AI 模式，说"退出傻妞"结束。
• 对话记忆：服务用本地数据库保存聊天记录，前后两句能接上文。
• 可换音色：支持接入第三方 TTS 服务，替换小爱自带的声音。

小爱音箱接入 ChatGPT 前要备齐的 5 样东西

动手前先做功课，下面 5 样缺一样，后面都会卡住：

1. 兼容型号：大部分小爱音箱可用，小爱音箱 Pro（LX06）体验最稳。你的型号支不支持、指令参数是多少，查 docs/compatibility.md，部分型号需要关闭连续对话开关。
2. 一台常驻机器：云主机或家里不关机的电脑，内存 4GB 以上，网络能稳定访问外网。
3. 运行环境：Docker 或 Node.js 20，二选一即可。
4. 小米账号：登录 account.xiaomi.com，在「个人信息」里能看到数字的小米 ID，注意不是手机号或邮箱。
5. 大模型 API Key：OpenAI 或任意 OpenAI 兼容接口，通义千问、豆包都走这条路。

获取 MiGPT 代码并建好两个配置文件

仓库放哪都行，但路径里别出现中文和空格，数据库初始化不认。克隆仓库，把两个示例文件复制成正式配置：

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env cp .migpt.example.js .migpt.js

之后只需要改新生成的.env和.migpt.js，其余代码不用动。

.env 里填哪 3 个参数：模型名、密钥、接口地址

服务调哪个大模型，由.env决定，必填只有 3 行：

OPENAI_MODEL=gpt-4o-mini OPENAI_API_KEY=sk-你的密钥 OPENAI_BASE_URL=https://api.openai.com/v1

换供应商时改的也是这 3 行：OPENAI_BASE_URL换成对方的接口地址（一般以 /v1 结尾），OPENAI_MODEL换成模型名，OPENAI_API_KEY换成对应密钥。文件里其他行都是可选项，保持注释状态即可。

.migpt.js 里最容易填错的 3 个字段

服务启动后音箱没反应，多数时候不是代码问题，是这 3 个字段：

module.exports = { speaker: { userId: "你的小米ID", password: "小米账号密码", did: "小爱音箱Pro", }, };

userId填数字小米 ID，登录 account.xiaomi.com 在「个人信息」页查；password是账号密码；did必须和米家 APP 里给音箱起的名字逐字一致。另外按你的型号核对ttsCommand和wakeUpCommand，小爱音箱 Pro 是[5, 1]和[5, 3]，其他型号见 docs/compatibility.md 的表格。

启动 MiGPT：Docker 一行命令或源码三步走

配置都改完后，Docker 路线只需要一条命令，在存放配置文件的那个目录执行：

docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest

Windows 终端里把$(pwd)换成绝对路径。用docker ps和docker logs确认容器在跑、日志里登录成功后，就可以对着音箱喊"小爱同学，请问天空为什么是蓝色的"来验证。

源码路线适合要改代码的人：装好 Node 20 和 pnpm，在仓库根目录依次执行pnpm install、pnpm build、pnpm dev。

最后提醒一点：该项目已停止维护，现有功能仍然完整可用。遇到报错先翻 docs/faq.md，大部分常见错误和对应处理方式都在里面。

【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt