MiGPT：把小爱音箱接入 ChatGPT 语音助手的零基础完整指南
【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt
你有没有对着"小爱同学"喊了半天，得到的却只是天气预报和冷笑话？MiGPT 就是专门解决这个问题的项目——它把 ChatGPT 等大模型的理解能力接进小爱音箱，让一台普通智能音箱变成真正能聊天的语音助手。
🧠 它能帮你解决什么
先看它解决的痛点。以前的小爱同学能力基本"写死"了：放音乐、定闹钟、查天气，到此为止。问它知识类问题，顶多搜个网页念几句，问得稍微绕一点就答非所问。
接入 MiGPT 后，你的问题会经过大语言模型处理，小爱用 AI 生成的答案回答你。它还可以被设定人设、拥有长短期记忆，记得你对话的上下文。前后对比，大约相当于从"声控遥控器"换成了"数字家庭成员"。
🔬 核心能力拆解：不改硬件，它如何"接管"智能音箱
关键在 3 处。
小米 IoT 接口深度整合
云端接口控制。MiGPT 通过小米 IoT 生态的开放接口（MIoT 与 MiNA）控制小爱音箱的播放、暂停、唤醒，音箱和服务端无需处于同一局域网，放在任意电脑或服务器上运行都行。这也解释了它为什么只支持小米系音箱，小度、天猫精灵等品牌不在支持范围内。
智能对话轮询机制
轮询 + AI 应答。服务会持续轮询音箱的对话列表，捕捉你最新的语音指令，识别到提问后立刻调用大模型，并把合成语音播回音箱。由此带来一个已知小缺陷：小爱开始说话到 MiGPT 察觉有 1-2 秒延迟，期间原版小爱可能"抢话"，项目用播放静音音频的方式让它闭嘴，算是曲线救国。
MiGPT 启动界面：服务启动后，能以"豆包"等自定义人设回应你的提问
多源 TTS 语音合成
音色可切换。默认用小爱自带 TTS 引擎，响应最快；如果你不喜欢原版音色，可以接入火山引擎（豆包同款）等第三方语音合成服务，甚至本地部署的 TTS，还能用"把声音换成 xxx"这类语音指令随时换音色。
🏠 谁会用、怎么用到：3 个真实场景
部署完成后，玩法因人而异。
如果你是学生或家长，可以把作业辅导搬进客厅
孩子遇到不会的题，说一句"小爱同学，请解释为什么地球是圆的"，音箱会给出详细讲解。相比掏手机，对着音箱提问少了分心的可能，也方便全家一起听。
如果你是角色扮演爱好者，可以调一个专属人设
配置里可以设定 AI 的名字、性格，以及你自己的人设，再用固定口令进入连续对话模式。进入后不用每句都说"小爱同学"，直接连续提问，体验更接近和真人聊天。
如果你是开发者，可以把它当二次开发的底座
项目同时发布为 npm 包 mi-gpt，几行代码就能集成进自己的 Node.js 应用。源码里的长短期记忆模块和提示词模板机制，也足够你尝试自己的家用智能体思路。
🚀 快速上手：一条命令跑通
想直接体验的话，这部分是最短路径。先准备好 3 样东西：一台受支持的小爱音箱（推荐小爱音箱 Pro）、一个小米账号（含小米 ID——不是手机号或邮箱——和密码）、一个兼容 OpenAI API 的大模型密钥（如 OpenAI、豆包、通义千问）。然后按官方文档配好.env和.migpt.js两个文件，执行：
docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest启动后说一句"小爱同学，请 xxx"或"小爱同学，召唤 xxx"，音箱用 AI 风格回答了，就成了。
⚠️ 进阶技巧与注意事项
动手前先说一件正事：本项目已官方停止维护，不再提供更新与支持。它目前仍可运行，但相关风险需自行承担，使用时请遵守所在地区的法律法规。
如何加快 AI 响应速度
默认参数偏保守，回复会显得慢。可以切换成小爱自带 TTS 引擎、关闭 AI 应答前后的提示语，并把播放状态检测间隔缩短到 500 毫秒，连续问答之间的停顿感会明显减少；追求更快，就选 gpt-3.5-turbo 这类轻量模型。
型号兼容与常见坑
不同音箱型号的 TTS、唤醒指令各不相同，如果 AI 有回答但音箱不播报，就到小米 MIoT 规格站按型号查一下，把配置文件里的 ttsCommand 参数改成对应值。还有 2 个坑："70016 登录验证失败"一般是小米 ID 填错（它不是手机号或邮箱）；"找不到设备"则是设备名称与米家中不一致，多一个空格、差一个大小写都会失败。
在 MIoT 规格站按型号查询后，表格中列出的即 MiGPT 配置文件中对应的 TTS 与唤醒指令
一句话总结：MiGPT 是把智能音箱"装上大脑"最有代表性的开源尝试之一，IoT 接口控制、对话轮询、多源 TTS 这套组合拳已被充分验证。虽然项目已停止更新，但源码完全开放，想弄清"音箱怎么接大模型"很值得一读，也可以照这个思路去找社区仍在维护的同类项目（README 中还推荐了面向小爱 Pro 用户的 Open-XiaoAI）。
【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
