30分钟把小爱音箱接入大模型MiGPT 完整配置教程【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个能把小爱音箱接入 ChatGPT、豆包等大模型的开源项目把家里现成的音箱变成你的专属语音助手。适合手里有小爱音箱、想体验 AI 对话的新手。晚上你对着音箱说我有点烦出厂版回你一句为你播放音乐改造之后它会反问发生什么了说给我听。硬件没动换的是那颗会聊天的脑子。一、MiGPT 是什么能干什么MiGPT 走的是小米 IoT 开放接口它监听你的语音转发给大模型再用 TTS 把 AI 的回答念出来。一句话——不改硬件、不刷机把音箱里那颗题库脑换成联网脑。顺带说明项目目前已停止维护但核心功能完整可用不会再加新功能。核心能力有三项AI 问答语义理解取代关键词匹配流式响应回答不用干等长短期记忆对话上下文和你的偏好会落库保存越聊越懂你人设与音色名字、性格、TTS 音色都可以改音箱可以换脸对比维度出厂小爱接入大模型后理解方式关键词匹配固定话术语义理解换个说法也能接住知识边界内置固定词条大模型知识库随问随答人设系统默认可自定义名字和性格对话记忆说完就忘长短期记忆声音小爱默认音色可接第三方 TTS 换声二、我能用吗先准备什么一台小爱音箱——大部分型号都支持推荐小爱音箱 Pro完整型号清单见 docs/compatibility.md一个小米账号——注意要填的是小米 ID在官网个人信息里查看一台能跑 Node.js 16 或 Docker 的机器——旧电脑、NAS、云服务器都行一个大模型 API Key——OpenAI、通义千问、DeepSeek 等兼容 OpenAI SDK 的服务都可以⚠️ 最容易踩的点本项目只认小米系小爱音箱小度、天猫精灵、HomePod 都不支持小爱音箱 HD 和蓝牙随身版两个型号也不支持。设备不在此列的话可以不用往下看了。三、怎么跑起来完整配置流程3.1 获取代码与安装依赖把项目拉到本地并装依赖git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install这一步只是把程序装进电脑装完依赖后面才开始动配置。3.2 小爱音箱信息配置.migpt.js把根目录的.migpt.example.js重命名为.migpt.js把 speaker 下几个字段改成你的speaker: { userId: 987654321, // 小米 ID不是手机号或邮箱 password: 你的密码, did: 小爱音箱Pro, // 米家中显示的名称注意空格和大小写 ttsCommand: [5, 1], // TTS 指令 wakeUpCommand: [5, 3], // 唤醒指令 }这份文件相当于音箱的身份证告诉程序用哪个账号、控制哪台设备、发什么指令。ttsCommand和wakeUpCommand因型号而异多数音箱用默认值即可。拿不准就去 miot-spec 站点搜你的型号进入结果里的 intelligent-speaker 服务确认 play-text 与 wake-up 方法对应的指令编号3.3 大模型 API Key 配置.env同样把.env.example重命名为.env填入密钥OPENAI_API_KEY你的密钥 OPENAI_MODELgpt-4o-mini OPENAI_BASE_URLhttps://api.openai.com/v1这个文件决定接哪颗脑子。变量名是固定的接通义千问时只需把OPENAI_BASE_URL的值改成https://dashscope.aliyuncs.com/compatible-mode/v1OPENAI_MODEL改成qwen-turbo。3.4 启动服务Node 用户直接运行pnpm start没装 Node 环境就用 Docker一条命令docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest启动后程序会先登录小米账号、绑定音箱。控制台不报错就可以拿音箱试听了。四、启动之后怎么验证、怎么用先照念一遍这几句逐条验证小爱同学天空为什么是蓝色的——验证 AI 问答小爱同学法国的首都是哪里——验证知识问答小爱同学召唤傻妞——验证唤醒模式成功的样子音箱先念一句让我先想想之类的提示语然后把大模型的回答流式念出来最后以我说完了收尾。两个注意点必须先喊小爱同学唤醒。直接说天空为什么是蓝色的而不带唤醒词音箱没在听收不到你的话。有个已知的小缺陷AI 回答前 1-2 秒原小爱可能先抢话。这是云端轮询造成的延迟属于正常现象。回答太长时说一句小爱同学请你闭嘴就能打断。五、值得试的进阶功能5.1 连续对话唤醒模式效果不用每句话都喊小爱同学直接连续聊。 怎么配在.migpt.js中把streamResponse设为true并定义进入与退出关键词speaker: { streamResponse: true, wakeUpKeywords: [召唤傻妞, 打开AI模式], exitKeywords: [退出AI模式, 再见], }例子说完小爱同学召唤傻妞之后直接追问那它的首府是哪个城市就行不用再加前缀。超过 30 秒不提问会自动退出。注意并非所有型号都支持连续对话先对照兼容性列表。5.2 一句话换人设效果不重启、不改文件一句话就能换掉音箱的性格。 怎么配默认人设在.migpt.js的bot.name和bot.profile里设置运行中也可以直接用语音覆盖。 例子小爱同学你是一位严厉的老师请听我背课文。之后它会按这个身份和你聊下去。5.3 换真人音色第三方 TTS效果机械音换成真人音色还能随时用语音换声。 怎么配搭一个 TTS 服务火山引擎接口实名认证后可免费用 21 款音色在.env填TTS_BASE_URL在.migpt.js里把tts设为custom完整教程见 docs/tts.md。 例子小爱同学把声音换成甜美台妹当场切换。六、卡住了对照这里70016登录验证失败 → 把手机号或邮箱当成了小米 ID → 去官网个人信息查小米 ID后重填找不到设备xxx → did 与米家名称不完全一致多余空格、大小写、错别字→ 直接复制米家里的名称或开调试模式查设备 did触发小米账号异地登录安全验证 → 网络环境变化触发风控 → 在与 MiGPT 相同的网络下用浏览器登录小米官网完成验证等待约 1 小时LLM 响应异常 Connection error → 国内网络访问不了 OpenAI → 换通义千问、DeepSeek 等国产模型或给HTTP_PROXY配代理回答总是戛然而止 → 该型号查不到播放状态 → 按规格文档补上playingCommand如[3, 1, 1]说话没反应 → 提问时机不对AI 还在说或没唤醒→ 等我说完了念完再说或重新小爱同学xxx唤醒结尾更多排查思路先看 docs/faq.md。现在去把代码 clone 下来对着音箱说出那句小爱同学召唤你的 AI第一次回应就会告诉你这半小时值不值。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考