
小爱音箱接入大模型完整教程用 MiGPT 把它调教成专属语音助手【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt问小爱音箱明天降温穿什么它甩来三句天气预报追问一句就忘了前文。开源项目 MiGPT 把小爱音箱直接接到 ChatGPT、豆包等大模型上支持连续对话、自定义人设和第三方 TTS 音色。这篇只讲三件事它的能力边界、部署方法、最常翻车的坑。 先看边界哪些能做哪些别指望使用场景接入前接入 MiGPT 后多轮追问每句都要小爱同学开头唤醒模式下连续提问不用重复唤醒人设出厂固定自己写 profile还能口头临时改音色小米 TTS 机械音可换火山引擎 21 款免费音色豆包同款记忆单轮独立短期 长期记忆四条明确的不能先说好免得白折腾只认小爱音箱小度、天猫精灵、HomePod 不支持也没有适配计划小爱同学这个唤醒词是固件写死的外部改不了控制米家灯、插座这类设备联动还是 todo没开始开发项目已停止维护功能冻结在当前版本不再有更新 装之前先对号入座你的型号在不在名单里docs/compatibility.md 把型号分成三档完美运行支持连续对话小爱音箱 ProLX06、Xiaomi 智能音箱 ProOH2P、小爱音箱万能遥控版等正常运行不支持连续对话小爱音箱L06A、mini、Play、Art、触屏音箱等完全不支持小米小爱音箱 HDSM4等档与档的差别集中在两条设备指令上示例对比型号ttsCommandwakeUpCommand连续对话小爱音箱 ProLX06[5, 1][5, 3]支持Xiaomi 智能音箱 ProOH2P[7, 3][7, 1]支持小爱音箱L06A[5, 1][5, 2]不支持型号不在表里也没关系把配置里的debug和enableTrace打开重启日志里能查到设备列表和指令参数照抄进配置即可。 从 clone 到跑起来一条命令的事git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt再把两份示例配置改个名这才是容器真正挂载的文件跳过这步容器会直接报找不到配置cp .migpt.example.js .migpt.js cp .env.example .envDocker 启动推荐给不想折腾 Node 环境的人docker run -d --env-file $(pwd)/.env \ -v $(pwd)/.migpt.js:/app/.migpt.js \ idootop/mi-gpt:latestWindows 的 PowerShell/cmd 不认$(pwd)两处路径要手写成绝对路径。启动成功后有三种用法难度递增小爱同学请 xxx单次问答比如请问地球为什么是圆的小爱同学你 xxx带人设对话比如你喜欢我吗小爱同学召唤傻妞进入唤醒模式之后连续提问不用每句带小爱同学⚙️ 两个配置文件哪一行最容易填错.env管接哪个大模型.migpt.js管音箱是谁、人设是什么。接 OpenAI 只需要两行OPENAI_MODELgpt-4o OPENAI_API_KEYsk-xxxxxxxx想换国产模型小爱音箱接入豆包、通义千问都是这个路子变量名不动只改接口地址OPENAI_MODELqwen-turbo OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1豆包这类不兼容 OpenAI API 的模型用 One API 之类中转服务转成 OpenAI 格式再填进同样的变量。.migpt.js里最容易翻车的是这三行speaker: { userId: 987654321, // 纯数字小米 ID登录小米官网个人信息页可查 did: 小爱音箱Pro, // 必须和米家 APP 里一字不差 ttsCommand: [5, 1], // 按型号查别照抄别人的 }did的三大死因多一个空格小爱音箱 Pro、大小写小爱音箱pro、错别字小爱音响。名称核对无误还报找不到设备就是 Mina 和 MIoT 两套名称不一致此时把enableTrace: true打开日志里的miotDID数字 ID 直接填进did最稳。 调教空间人设、关键词和连续对话默认 AI 叫傻妞人设写在.migpt.example.js的bot.profile性格、爱好你自己的设定在master.profile整套对话规则模板是systemTemplate可参考 docs/prompt.md 里的变量说明。改人设不用改文件重启——直接说小爱同学你是xxx你xxx就能口头覆盖。三类关键词决定哪句话会触发大模型callAIKeywords: [请, 你, 傻妞], // 开头命中就交给 AI 回答 wakeUpKeywords: [打开, 进入, 召唤], // 命中进唤醒模式 exitKeywords: [关闭, 退出, 再见], // 命中退出唤醒模式连续对话有三个容易忽略的使用细节它说完结尾提示语默认我说完了还有其他问题吗之后你再开口它回答中途说的话是听不见的突然没反应多半是超过exitKeepAliveAfter默认 30 秒自动退出了重新召唤傻妞即可回答太长想打断说小爱同学请你闭嘴 换声音接入第三方 TTS 换豆包同款音色默认走小米自带 TTS声音偏机械。项目留了标准接口填一个 TTS 服务地址再把引擎切成customTTS_BASE_URLhttp://192.168.31.205:4321/xxxx/apispeaker: { tts: custom }官方配套的 MiGPT-TTS 服务接了火山引擎实名认证后有 21 款免费音色配好后说小爱同学把声音换成 xxx就能语音切音色。TTS_BASE_URL不能写 localhost要用音箱能访问到的局域网或公网地址。细节见 docs/tts.md。 翻车速查现象、原因和解法启动报70016登录验证失败原因账号密码不对或把手机号当成了小米 ID。小米 ID 是纯数字登录小米官网在个人信息页查看填进userId。提示触发异地登录保护原因服务器 IP 和常用登录地不一致。解法在跑 MiGPT 的同一网络下登录一次小米官网手动通过安全验证等约 1 小时再启动。还不行的终极方案先在本地网络跑通把生成的.mi.json拷到服务器挂载到容器/app/.mi.json。找不到设备xxx初始化失败原因did与米家名称对不上。先逐字核对名称仍失败就用miotDID数字 ID。注意共享到别人账号下的音箱Mina 接口拿不到必须挂在你自己账号下。控制台有 AI 回复音箱却不出声原因ttsCommand填错。不同型号指令不同按 docs/compatibility.md 里你型号的 AIID 配置。回答说到一半戛然而止原因设备查不到播放状态MiGPT 误判为播完。先补上playingCommand如[3, 1, 1]配了仍不行说明该设备不支持开放接口查状态只能关掉streamResponse代价是连续对话失效。喊了没反应音箱装死原因没先唤醒就说话。必须小爱同学开头进入听写状态才接得住后面的请 xxx。AI 回答前小爱先抢一句这条无解。原理是轮询云端对话列表发现小爱在回复、再播静音把它盖掉1~2 秒延迟是物理限制官方 FAQ 也写明只有刷机才能根治属于已知缺陷。✅ 下一步清单打开 docs/compatibility.md确认你的型号落在完美运行或正常运行档复制两份示例配置填好userId纯数字小米 ID和did与米家逐字一致Docker 一条命令启动Windows 用户记得把$(pwd)换成绝对路径先用小爱同学请介绍下你自己验证链路通了再折腾唤醒模式和 TTS出问题先翻 docs/faq.md本文列的坑基本都有现成答案卡在第 2 步别慌找不到设备和70016占了启动失败的绝大多数——名字逐字对一遍、ID 换成纯数字九成情况当场就通了。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考