小爱音箱接入 ChatGPT 大模型语音助手MiGPT 实操部署指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt这篇文章写给家里有小爱音箱、想给它换上大模型大脑的人。你不需要刷机也不需要会写代码跟着做大约五到十分钟就能跑通部署开源项目 MiGPT把小爱音箱接入 ChatGPT、豆包等大模型。以后你用语音向小爱提问回答你的不再是预设的答案而是大模型生成的内容。先感受一下差别同样的话接入大模型之前和之后效果差别很明显说提醒我下午五点接孩子。原来的小爱同学直接执行接入大模型后依然能执行而且会结合上下文比如你早上提过明天家长会它能主动关联起来。问黑洞是怎么形成的。原来的回答基本是念一段百科词条一句回答完毕就结束换成大模型后它会分点讲清楚成因还能按你的要求讲得再简单一点。说帮我写一封给物业的感谢信语气客气一点。原来的小爱同学基本接不住这类请求大模型可以直接生成一段完整的文字读给你听。区别的本质就一条从查固定答案变成理解你的问题再回答。开始前的四件事动手前把下面四项过一遍能避开部署中大部分报错确认设备型号去米家 App 查看你的音箱型号。已知完美运行的有小爱音箱 ProLX06、Xiaomi 智能音箱 ProOH2P、小米 AI 音箱第二代L15A等小爱音箱 miniLX01、小爱触屏音箱LX04等可以运行但部分功能受限。不支持的设备范围要记牢小度音箱、天猫精灵、HomePod 不在支持列表内小爱音箱 HDSM4、小米小爱蓝牙音箱随身版也不支持。型号和对应参数可查 docs/compatibility.md。确认音箱绑定在你自己账号下MiGPT 是用你的小米账号登录并查找设备的共享给别人的设备拿不到启动时会报找不到设备。检查网络环境运行 MiGPT 的机器必须能访问你配置的大模型接口。在国内直连 OpenAI 需要走代理在.env里填HTTP_PROXY或者干脆换通义千问、DeepSeek 等国内模型后面会讲。提前查好两个指令参数ttsCommand让小爱朗读文字的指令和wakeUpCommand唤醒指令因型号而异比如小爱音箱 Pro 分别是[5, 1]和[5, 3]。查错或不填音箱会出现有回复但不出声的情况。五分钟跑起来复制这两个文件就能启动所有方式都要先拿到仓库并准备配置文件git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .migpt.example.js .migpt.js cp .env.example .env第一条命令把 MiGPT 仓库下载到本地第二、三条把两份示例配置复制成正式配置文件。接下来只改这两个文件.migpt.js里改userId、password、did。注意userId是小米 ID在小米账号个人信息页查看不是手机号或邮箱填错会报70016登录验证失败did填米家中给音箱设置的名称空格、大小写、错别字都要一致填错会报找不到设备这两个型号专属指令也在这里按你的型号核对。.env里改OPENAI_API_KEY你的模型服务密钥、OPENAI_MODEL模型名、OPENAI_BASE_URL模型服务地址默认 OpenAI。Docker 方式新手推荐两个文件改完后一条命令启动docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest这条命令把容器在后台跑起来并把你的两个配置文件映射进容器。Windows 终端里$(pwd)不生效要换成.env和.migpt.js的绝对路径。源码方式开发者可选如果你想读源码或二次开发就在仓库目录里依次执行pnpm install pnpm db:gen pnpm start第一条安装依赖第二条初始化本地数据库Prisma 建表第三条启动服务。注意 Node.js 要 16 以上。看日志确认跑通启动成功的标志是控制台依次打印服务已启动和音箱设备信息。这时对着音箱说小爱同学请介绍一下你自己它能用大模型的内容回答你就说明部署完成了。跑起来之后把体验调到位只动这五处体验改善最明显长期记忆什么时候改——想让音箱记得你们聊过什么。怎么改——.migpt.js里的systemTemplate中保留了{{shortTermMemory}}和{{longTermMemory}}两个变量它们就是短、长期记忆的注入位保留即可。效果——聊完一轮第二天再问它能接住之前的话题不会每次都像初次见面。自定义角色和唤醒词什么时候改——想让它换个身份或换一种召唤方式。怎么改——把bot.name、bot.profile改成你想要的名字和人设wakeUpKeywords默认[打开, 进入, 召唤]决定用哪句话进入连续对话状态。也可以不碰文件直接说小爱同学你是英语老师你负责陪我练口语临时设定。效果——同一个音箱可以有不同的性格和召唤口令。TTS 引擎什么时候改——听腻了小爱自己的声音或者内容涉及敏感词被小米 TTS 拦截。怎么改——在.env配TTS_BASE_URL指向一个 TTS 服务再把speaker.tts从xiaoai改成custom另外部分型号ttsCommand不是默认值需要到 MIoT 规格页查自家型号的指令AIID 对应关系见下图。效果——回答换成别的音色还能用小爱同学把声音换成 xxx随时切换。详见 docs/tts.md。连续对话什么时候改——嫌每句话都要喊一遍小爱同学。怎么改——确认你的型号支持后把streamResponse设为true。效果——小爱同学召唤傻妞进入 AI 状态后可以连着问不用每次重新唤醒。不支持的型号保持关闭否则回答会说到一半被截断。切换模型什么时候改——不想用 OpenAI或者想换个更快的模型。怎么改——只改.env里OPENAI_MODEL、OPENAI_API_KEY、OPENAI_BASE_URL三个值兼容 OpenAI 接口的国产模型通义千问、DeepSeek 等直接填对应值即可豆包等不兼容的模型可以经过 One API 这类聚合工具转成 OpenAI 格式后再接入。效果——同一个部署换模型不用改任何代码。背后是怎么工作的MiGPT 不改动音箱的固件它靠三层协作工作最底层通过小米 IoT 生态开放的 MIoT、MiNA 接口控制小爱音箱做播放、暂停、唤醒这些动作中间层是大模型服务负责真正生成回答最上层的src/services/bot负责应用逻辑包括对话轮询、记忆管理和角色设定。具体流程是程序持续轮询设备对话列表拿到你的语音消息命中关键词比如请就带上上下文调用大模型拿到回答后再交给 TTS 合成语音发回音箱播放。因为要经过音箱上报状态—小米云端—轮询拿到这条链路回答前有 1 到 2 秒的固有延迟属于方案特性不是你的网络问题。更多细节见 docs/how-it-works.md。用起来三种真实玩法学习助手小爱同学请给我讲一下 JavaScript 闭包是什么。大模型会像老师一样分步解释还可以追问举个例子。生活管家小爱同学请帮我写一段给邻居的感谢词五十字以内。适合临时需要一段得体文字、又不想掏手机的时候。工作搭子小爱同学请帮我写一封给客户的邮件草稿说明项目延期一周。生成后它读给你听你可以要求改得更委婉一点再听一遍。出了问题怎么办症状最可能原因排查动作音箱完全没反应或启动时报70016登录验证失败小米 ID 填成了手机号/邮箱或密码错误到小米账号个人信息页复制小米 ID 填入userId再核对password启动时报找不到设备xxxdid和米家中的设备名不一致或音箱是共享设备直接复制米家里的设备名称注意空格和大小写共享设备换绑到自己账号控制台有 AI 回复音箱不发声ttsCommand与你的型号不匹配到 MIoT 规格页查该型号的 play-text 指令更新.migpt.js后重启容器回答说到一半戛然而止该型号查不到播放状态流式判断出错查playingCommand仍无解就把streamResponse设为false报Connection error或 401/403网络不通、API 密钥无效或代理被风控检查OPENAI_API_KEY是否有效国内访问 OpenAI 在.env加HTTP_PROXY或改用国内模型回答明显变慢模型响应慢或提示语多换gpt-4o-mini等更快的模型把onAIAsking、onAIReplied设为空数组减少等待安全与长期使用.migpt.js里存着你的小米账号密码.env里存着 API 密钥这两个文件不要贴到聊天群、截图或公开仓库里。API 密钥定期换一换密钥在.env里换完重启容器即可生效。留意项目更新。本项目 README 顶部已注明停止维护后续修复和兼容进展需要自行关注社区。把配置文件留一份备份换服务器或重装时直接复用能省掉重新排错的麻烦。账号和密钥都按最小使用原则对待部署完确认服务正常后不要长期把容器端口暴露到公网。到这里你已经知道怎么判断设备能不能用、五个配置文件怎么填、两条启动路径怎么选。现在就可以做的第一件事克隆仓库把userId、did和 API 密钥填进两个配置文件然后跑 Docker 那条命令。相关文档docs/settings.md全部配置参数说明docs/faq.md启动、播放、网络三类高频问题docs/tts.md第三方 TTS 接入教程docs/compatibility.md兼容型号与指令参数清单【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 小爱音箱接入 ChatGPT 大模型语音助手：MiGPT 实操部署指南
小爱音箱接入 ChatGPT 大模型语音助手MiGPT 实操部署指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt这篇文章写给家里有小爱音箱、想给它换上大模型大脑的人。你不需要刷机也不需要会写代码跟着做大约五到十分钟就能跑通部署开源项目 MiGPT把小爱音箱接入 ChatGPT、豆包等大模型。以后你用语音向小爱提问回答你的不再是预设的答案而是大模型生成的内容。先感受一下差别同样的话接入大模型之前和之后效果差别很明显说提醒我下午五点接孩子。原来的小爱同学直接执行接入大模型后依然能执行而且会结合上下文比如你早上提过明天家长会它能主动关联起来。问黑洞是怎么形成的。原来的回答基本是念一段百科词条一句回答完毕就结束换成大模型后它会分点讲清楚成因还能按你的要求讲得再简单一点。说帮我写一封给物业的感谢信语气客气一点。原来的小爱同学基本接不住这类请求大模型可以直接生成一段完整的文字读给你听。区别的本质就一条从查固定答案变成理解你的问题再回答。开始前的四件事动手前把下面四项过一遍能避开部署中大部分报错确认设备型号去米家 App 查看你的音箱型号。已知完美运行的有小爱音箱 ProLX06、Xiaomi 智能音箱 ProOH2P、小米 AI 音箱第二代L15A等小爱音箱 miniLX01、小爱触屏音箱LX04等可以运行但部分功能受限。不支持的设备范围要记牢小度音箱、天猫精灵、HomePod 不在支持列表内小爱音箱 HDSM4、小米小爱蓝牙音箱随身版也不支持。型号和对应参数可查 docs/compatibility.md。确认音箱绑定在你自己账号下MiGPT 是用你的小米账号登录并查找设备的共享给别人的设备拿不到启动时会报找不到设备。检查网络环境运行 MiGPT 的机器必须能访问你配置的大模型接口。在国内直连 OpenAI 需要走代理在.env里填HTTP_PROXY或者干脆换通义千问、DeepSeek 等国内模型后面会讲。提前查好两个指令参数ttsCommand让小爱朗读文字的指令和wakeUpCommand唤醒指令因型号而异比如小爱音箱 Pro 分别是[5, 1]和[5, 3]。查错或不填音箱会出现有回复但不出声的情况。五分钟跑起来复制这两个文件就能启动所有方式都要先拿到仓库并准备配置文件git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .migpt.example.js .migpt.js cp .env.example .env第一条命令把 MiGPT 仓库下载到本地第二、三条把两份示例配置复制成正式配置文件。接下来只改这两个文件.migpt.js里改userId、password、did。注意userId是小米 ID在小米账号个人信息页查看不是手机号或邮箱填错会报70016登录验证失败did填米家中给音箱设置的名称空格、大小写、错别字都要一致填错会报找不到设备这两个型号专属指令也在这里按你的型号核对。.env里改OPENAI_API_KEY你的模型服务密钥、OPENAI_MODEL模型名、OPENAI_BASE_URL模型服务地址默认 OpenAI。Docker 方式新手推荐两个文件改完后一条命令启动docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest这条命令把容器在后台跑起来并把你的两个配置文件映射进容器。Windows 终端里$(pwd)不生效要换成.env和.migpt.js的绝对路径。源码方式开发者可选如果你想读源码或二次开发就在仓库目录里依次执行pnpm install pnpm db:gen pnpm start第一条安装依赖第二条初始化本地数据库Prisma 建表第三条启动服务。注意 Node.js 要 16 以上。看日志确认跑通启动成功的标志是控制台依次打印服务已启动和音箱设备信息。这时对着音箱说小爱同学请介绍一下你自己它能用大模型的内容回答你就说明部署完成了。跑起来之后把体验调到位只动这五处体验改善最明显长期记忆什么时候改——想让音箱记得你们聊过什么。怎么改——.migpt.js里的systemTemplate中保留了{{shortTermMemory}}和{{longTermMemory}}两个变量它们就是短、长期记忆的注入位保留即可。效果——聊完一轮第二天再问它能接住之前的话题不会每次都像初次见面。自定义角色和唤醒词什么时候改——想让它换个身份或换一种召唤方式。怎么改——把bot.name、bot.profile改成你想要的名字和人设wakeUpKeywords默认[打开, 进入, 召唤]决定用哪句话进入连续对话状态。也可以不碰文件直接说小爱同学你是英语老师你负责陪我练口语临时设定。效果——同一个音箱可以有不同的性格和召唤口令。TTS 引擎什么时候改——听腻了小爱自己的声音或者内容涉及敏感词被小米 TTS 拦截。怎么改——在.env配TTS_BASE_URL指向一个 TTS 服务再把speaker.tts从xiaoai改成custom另外部分型号ttsCommand不是默认值需要到 MIoT 规格页查自家型号的指令AIID 对应关系见下图。效果——回答换成别的音色还能用小爱同学把声音换成 xxx随时切换。详见 docs/tts.md。连续对话什么时候改——嫌每句话都要喊一遍小爱同学。怎么改——确认你的型号支持后把streamResponse设为true。效果——小爱同学召唤傻妞进入 AI 状态后可以连着问不用每次重新唤醒。不支持的型号保持关闭否则回答会说到一半被截断。切换模型什么时候改——不想用 OpenAI或者想换个更快的模型。怎么改——只改.env里OPENAI_MODEL、OPENAI_API_KEY、OPENAI_BASE_URL三个值兼容 OpenAI 接口的国产模型通义千问、DeepSeek 等直接填对应值即可豆包等不兼容的模型可以经过 One API 这类聚合工具转成 OpenAI 格式后再接入。效果——同一个部署换模型不用改任何代码。背后是怎么工作的MiGPT 不改动音箱的固件它靠三层协作工作最底层通过小米 IoT 生态开放的 MIoT、MiNA 接口控制小爱音箱做播放、暂停、唤醒这些动作中间层是大模型服务负责真正生成回答最上层的src/services/bot负责应用逻辑包括对话轮询、记忆管理和角色设定。具体流程是程序持续轮询设备对话列表拿到你的语音消息命中关键词比如请就带上上下文调用大模型拿到回答后再交给 TTS 合成语音发回音箱播放。因为要经过音箱上报状态—小米云端—轮询拿到这条链路回答前有 1 到 2 秒的固有延迟属于方案特性不是你的网络问题。更多细节见 docs/how-it-works.md。用起来三种真实玩法学习助手小爱同学请给我讲一下 JavaScript 闭包是什么。大模型会像老师一样分步解释还可以追问举个例子。生活管家小爱同学请帮我写一段给邻居的感谢词五十字以内。适合临时需要一段得体文字、又不想掏手机的时候。工作搭子小爱同学请帮我写一封给客户的邮件草稿说明项目延期一周。生成后它读给你听你可以要求改得更委婉一点再听一遍。出了问题怎么办症状最可能原因排查动作音箱完全没反应或启动时报70016登录验证失败小米 ID 填成了手机号/邮箱或密码错误到小米账号个人信息页复制小米 ID 填入userId再核对password启动时报找不到设备xxxdid和米家中的设备名不一致或音箱是共享设备直接复制米家里的设备名称注意空格和大小写共享设备换绑到自己账号控制台有 AI 回复音箱不发声ttsCommand与你的型号不匹配到 MIoT 规格页查该型号的 play-text 指令更新.migpt.js后重启容器回答说到一半戛然而止该型号查不到播放状态流式判断出错查playingCommand仍无解就把streamResponse设为false报Connection error或 401/403网络不通、API 密钥无效或代理被风控检查OPENAI_API_KEY是否有效国内访问 OpenAI 在.env加HTTP_PROXY或改用国内模型回答明显变慢模型响应慢或提示语多换gpt-4o-mini等更快的模型把onAIAsking、onAIReplied设为空数组减少等待安全与长期使用.migpt.js里存着你的小米账号密码.env里存着 API 密钥这两个文件不要贴到聊天群、截图或公开仓库里。API 密钥定期换一换密钥在.env里换完重启容器即可生效。留意项目更新。本项目 README 顶部已注明停止维护后续修复和兼容进展需要自行关注社区。把配置文件留一份备份换服务器或重装时直接复用能省掉重新排错的麻烦。账号和密钥都按最小使用原则对待部署完确认服务正常后不要长期把容器端口暴露到公网。到这里你已经知道怎么判断设备能不能用、五个配置文件怎么填、两条启动路径怎么选。现在就可以做的第一件事克隆仓库把userId、did和 API 密钥填进两个配置文件然后跑 Docker 那条命令。相关文档docs/settings.md全部配置参数说明docs/faq.md启动、播放、网络三类高频问题docs/tts.md第三方 TTS 接入教程docs/compatibility.md兼容型号与指令参数清单【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考