小爱音箱接大语言模型：MiGPT 部署完成，5分钟拥有AI语音助手

小爱音箱接大语言模型：MiGPT 部署完成，5分钟拥有AI语音助手

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

问小爱"今天天气"，它播报当天的天气；问"天空为什么是蓝色的"，它回一句"我还在学习中"。MiGPT 是一个把大语言模型接入小爱音箱的开源项目，相当于给小爱接了个在线大脑：它听到你的问题，交给大模型作答，再让音箱把答案念出来。装好之后，智能音箱改造就完成了：天文地理生活琐事都能问，它用大白话回答，还记得上下文，睡前还能现编故事。

装完能得到什么

不用学新操作，还是像以前那样喊小爱同学：

• 日常问答："小爱同学，天空为什么是蓝色的？"它用大白话解释，不是念死板的脚本，你还可以接着追问"为什么"，它能继续答。
• 睡前故事："小爱同学，给我讲个睡前故事"，它当场开始现编一个，每次讲的内容都不一样。
• 角色扮演：把人设写进配置，小爱会变成乖巧的伙伴或话痨闺蜜，聊着聊着还能中途换性格。
• 记住以前的对话：上次聊到的事，这次它还记得，聊得越多越默契。

5分钟完成部署

准备，一共 3 样：

1. 一台小爱音箱。大部分型号都支持，小爱音箱 Pro 运行最稳；
2. 一个小米账号。小米 ID 是纯数字字符串，在小米账号"个人信息"页查看，不是手机号或邮箱；
3. 一个大语言模型的 API 密钥。凡是兼容 OpenAI 接口的服务都行，比如通义千问、DeepSeek、豆包。

最小配置，三步：

第一步，拿到项目代码：

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt

第二步，改配置。项目根目录下把.env.example改名为.env，填上模型 API 密钥；把.migpt.example.js改名为.migpt.js，填上小米 ID、账号密码，以及在米家里设置的音箱名称。

第三步，用 Docker 启动，一条命令：

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

Windows 终端下把$(pwd)换成配置文件的绝对路径即可。

成功验证：终端出现"服务已启动"，然后对着音箱说"小爱同学，你是谁"，音箱回了一段 AI 生成的自我介绍，就说明 MiGPT 部署成功了。

让它更像你

定制都集中在两个文件：.env管模型，.migpt.js管音箱。改完保存，重启容器生效。完整参数说明见参数设置。

• 回复风格：改.migpt.js里的bot.profile。人设写"乖巧、爱搞怪"，它就真的会带这种语气回答你；
• 模型选择：改.env里的OPENAI_MODEL和OPENAI_BASE_URL。换国产大模型接入更省事，部分模型回答速度更快；
• 音色：默认用小米自带的 TTS 引擎。想换更软的音色，可以接第三方 TTS，包括豆包同款音色，使用第三方 TTS里有完整教程；
• 响应速度：把.migpt.js里的onAIAsking和onAIReplied设成空数组，回答前后的"让我先想想""我说完了"提示音没了，等待感更短。

效果示意：

// .migpt.js export default { bot: { profile: "性别女，乖巧可爱，喜欢搞怪" }, speaker: { tts: "xiaoai", onAIAsking: [] }, };

常踩的坑

问：账号必须是纯数字 ID 吗？是的。小米 ID 是纯数字字符串，填手机号或邮箱都登不上。去小米账号的"个人信息"页看一眼，抄下那个数字。

问：启动时提示"70016：登录验证失败"？多半是账号或密码填错，先核对小米 ID。如果是触发了异地登录保护，在和小爱音箱同一网络的电脑上登录一次账号、手动通过安全验证，等大约 1 小时再启动。

问：装好后，对小爱说话它没反应？要先说"小爱同学，请 xxx"把它唤醒，而且只有以"请""你"这类触发词开头的消息才会调用大模型。触发词和唤醒模式的配置方法，见常见问题。

问：控制台打印了 AI 的回复，但音箱不发音？不同型号音箱的 TTS 指令不一样。去规格站点搜你的型号，对照下图把.migpt.js里的ttsCommand改成对应参数组。

问：AI 回答总是戛然而止，说不完整？部分型号不支持云端查询播放状态，下一句就接不上。按同样方法在规格站点查到播放状态参数，配置playingCommand。

问：我的型号能用吗？大部分小爱音箱型号都支持，Pro 最稳。拿不准就搜一下你的型号看有没有对应的指令参数，兼容的型号里也列了型号和配置。

继续探索

• 工作原理：MiGPT 轮询小爱对话、调用大模型、播放语音的完整链路，读完再排查问题更快；
• src/：核心源码目录，音箱控制逻辑在services/bot/，大模型调用在openai.ts，想二次开发从这里入手；
• 社区：更多社区教程、部署经验和相关项目，见项目 README 的"相关项目与教程"部分。

现在，书架上那个音箱除了报天气，你睡前也可以随便丢个问题给它——它会现编一个故事，讲给你听。

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