MiGPT 实战5 分钟把小爱音箱接入大模型【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt对着小爱音箱问量子纠缠是什么它居然能像真人一样给你讲上两句——这不是刷机也不是厂商新功能而是 MiGPT 做的事情把普通智能音箱接入大模型让小爱从只会答固定语料变成能多轮对话、记得住上下文的专属语音助手。这份实战指南面向第一次部署的新手带你亲手跑通全流程再拆一遍它背后的工作链路。MiGPT 是什么小爱音箱接入大模型方案速览MiGPT 是一个用 Node.js 写的开源服务装在你自己的电脑、NAS 或服务器上。它通过小米 MIoT 开放接口轮询音箱的对话记录命中关键词就把问题转给任意 OpenAI 兼容的大模型再把回答用 TTS 播回音箱。不刷机全程走官方云端接口。适合两类人手里有小爱音箱、想体验大模型语音对话的用户以及想在此基础上继续折腾智能家居 Agent 的开发者。一个提醒项目目前已停止维护但核心功能完整可用。对比项原生小爱接入 MiGPT 后知识来源固定语料复杂问题答非所问大模型实时生成可以追问对话方式单轮指令多轮连续对话带长短期记忆角色音色固定自定义人设可接第三方 TTS跑通 MiGPT 前需要准备什么三类要求都不复杂硬件一台列表内型号的小爱音箱ProLX06体验最稳设备要已登录小米账号并绑定到米家 App。docs/compatibility.md 把型号分了两档完美运行档Pro、LX06、L15A 等 9 款支持连续对话正常运行为档LX01、L05B 等只能单轮问答小米小爱音箱 HD 则明确不支持。软件Node.js 18.18 以上node --env-file参数的最低要求加 pnpm不想碰代码环境的直接装 Docker 走容器路线。账号一个可用的大模型 API Key。OpenAI 官方或通义千问、DeepSeek 等 OpenAI 兼容服务都行国内网络用后者更省心。还有个反直觉的点服务不用和音箱在同一局域网。它调的是小米云端接口在服务器上跑完全没问题。5 分钟跑通 MiGPT克隆、配置到启动第一步克隆代码git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt进目录能看到.env.example和.migpt.example.js两份模板这步就对了。第二步装依赖pnpm install装的过程中postinstall 钩子会自动跑一次 Prisma 迁移把本地 SQLite 数据库建好。依赖装完、没有报错这步通过。第三步配参数cp .env.example .env cp .migpt.example.js .migpt.js打开.env必填就三处OPENAI_API_KEY你的密钥# 大模型服务的 API KeyOPENAI_MODELgpt-4o-mini# 模型名换国产模型时改这里OPENAI_BASE_URLhttps://api.openai.com/v1# 接国产模型时换成对应服务的 OpenAI 兼容端点以通义千问为例BASE_URL 换成它的兼容模式地址MODEL 换成 qwen 系列变量名原样保留其他都不用动。再打开.migpt.js重点改speaker配置下的四处userId: 小米ID# 不是手机号也不是邮箱去「个人信息-小米 ID」里查password: 账号密码# 和小米 ID 是同一个账号did: 小爱音箱Pro# 直接复制米家里的设备名称空格、大小写、错别字都会导致找不到设备ttsCommand: [5, 1]与wakeUpCommand: [5, 3]# 不同型号指令不同小爱音箱 ProLX06就填这组其他型号去 docs/compatibility.md 查指令参数怎么查去小米 MIoT 规范网站搜你的型号打开规格文档第四步启动pnpm run dev这条命令会同时加载.env和.migpt.js。想走 Docker 路线的话配好这两个文件后一条docker run -d --env-file .env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest也能起Windows 终端下记得把$(pwd)换成绝对路径。另外 MiGPT 是单实例单账号一台机器跑一个实例对应一个小米账号和一台音箱。想多开就再起一个容器、换一份配置。第五步确认跑通控制台打出 MiGPT 的 ASCII 横幅后面跟着「服务已启动」字样——登录、连设备、初始化数据库全过了。走到音箱前说小爱同学请介绍一下你自己。先听到让我先想想接着音箱用大模型的口吻回答你这就是跑通的标志。想试连续对话说小爱同学召唤傻妞进入唤醒状态后后面几轮提问不用每句都带小爱同学前缀。小爱音箱 Pro 可以观察顶部指示灯常亮就是它在听其他型号等我说完了的提示语播完停一两秒再追问。如果音箱没动静先看控制台有没有登录或设备报错日志显示都正常却没声音多半是ttsCommand和型号不匹配。小爱音箱大模型回复链路是怎么走通的一条完整问答数据流就是「输入→处理→输出」输入你说出小爱同学请解释一下黑洞。音箱把语音上报小米云端落进这台设备的对话列表。处理src/services/speaker/speaker.ts按固定间隔轮询这份对话列表发现新消息就丢给src/services/speaker/ai.ts。那里有一组按顺序匹配的指令以唤醒词wakeUpKeywords开头的消息进入连续对话模式以 callAIKeywords默认请你开头的判定为 AI 问题。判定通过后src/services/bot/conversation.ts把消息连同短期记忆、长期记忆一起组装进系统提示词再由src/services/openai.ts发给大模型。输出回答被切成小段经src/services/speaker/stream.ts逐段下发 TTS音箱边收边播。所以你能听到秒回的流式效果而不是干等一整段。配置里的ttsCommand、wakeUpCommand看着像天书其实就是 MIoT 指令编号前一个数是功能域后一个数是方法序号。两个值得知道的细节。第一因为轮询间隔在秒级原生小爱有时会抢答一句这个问题我还不会提问后也有一两秒的思考延迟。MiGPT 的应对是立刻播一段静音音频把原生回答盖过去——代价是偶尔能听出半秒抢话这是不刷机方案下的已知边界。第二每轮对话都会写进本地 SQLite短期记忆保留最近的上下文长期记忆留重要细节下次提问自动带上。越聊越懂你是真的数据也全在你自己机器上。两个高频场景速配换人设与换模型场景一给小爱立个人设需求让它不只是答题机器而是有个固定性格的角色。改哪.migpt.js里的bot.profile角色简介和systemTemplate回复规则。懒得改文件直接说小爱同学你是xxx你xxx运行中就能换。验证问它你叫什么名字回答应该完全入戏。场景二换国产大模型提速需求OpenAI 连不上或回答太慢。改哪.env里OPENAI_BASE_URL、OPENAI_MODEL、OPENAI_API_KEY三行换成通义千问或 DeepSeek 的值变量名保持不变。验证重启后问同样的问题对比日志里从提问到首句回答的时间差国内节点通常快不止一倍。MiGPT 常见报错速查表症状最可能原因一条修复70016登录验证失败userId 填成了手机号或邮箱改成「个人信息-小米 ID」里的数字找不到设备xxxdid 与米家中名称不一致复制米家设备名覆盖.migpt.js的 didLLM 响应异常 / Connection error国内网络连不上 OpenAIOPENAI_BASE_URL改国产模型或配HTTP_PROXY回答说到一半戛然而止该型号查不到播放状态.migpt.js里streamResponse改为 false都没解决的话拿报错原文去 issue 区搜一遍docs/faq.md 也收了绝大部分高频问题包括异地登录保护的完整处理流程。下一步跟进更新与参与社区想看看项目动态和计划中的功能通知事件、MIoT Agents、RAG翻 docs/changelog.md 和 docs/roadmap.md。你踩的坑、你型号的指令参数发一条 issue 就是最实在的贡献——兼容列表就是社区用户一个个补出来的。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MiGPT 实战：5 分钟把小爱音箱接入大模型
MiGPT 实战5 分钟把小爱音箱接入大模型【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt对着小爱音箱问量子纠缠是什么它居然能像真人一样给你讲上两句——这不是刷机也不是厂商新功能而是 MiGPT 做的事情把普通智能音箱接入大模型让小爱从只会答固定语料变成能多轮对话、记得住上下文的专属语音助手。这份实战指南面向第一次部署的新手带你亲手跑通全流程再拆一遍它背后的工作链路。MiGPT 是什么小爱音箱接入大模型方案速览MiGPT 是一个用 Node.js 写的开源服务装在你自己的电脑、NAS 或服务器上。它通过小米 MIoT 开放接口轮询音箱的对话记录命中关键词就把问题转给任意 OpenAI 兼容的大模型再把回答用 TTS 播回音箱。不刷机全程走官方云端接口。适合两类人手里有小爱音箱、想体验大模型语音对话的用户以及想在此基础上继续折腾智能家居 Agent 的开发者。一个提醒项目目前已停止维护但核心功能完整可用。对比项原生小爱接入 MiGPT 后知识来源固定语料复杂问题答非所问大模型实时生成可以追问对话方式单轮指令多轮连续对话带长短期记忆角色音色固定自定义人设可接第三方 TTS跑通 MiGPT 前需要准备什么三类要求都不复杂硬件一台列表内型号的小爱音箱ProLX06体验最稳设备要已登录小米账号并绑定到米家 App。docs/compatibility.md 把型号分了两档完美运行档Pro、LX06、L15A 等 9 款支持连续对话正常运行为档LX01、L05B 等只能单轮问答小米小爱音箱 HD 则明确不支持。软件Node.js 18.18 以上node --env-file参数的最低要求加 pnpm不想碰代码环境的直接装 Docker 走容器路线。账号一个可用的大模型 API Key。OpenAI 官方或通义千问、DeepSeek 等 OpenAI 兼容服务都行国内网络用后者更省心。还有个反直觉的点服务不用和音箱在同一局域网。它调的是小米云端接口在服务器上跑完全没问题。5 分钟跑通 MiGPT克隆、配置到启动第一步克隆代码git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt进目录能看到.env.example和.migpt.example.js两份模板这步就对了。第二步装依赖pnpm install装的过程中postinstall 钩子会自动跑一次 Prisma 迁移把本地 SQLite 数据库建好。依赖装完、没有报错这步通过。第三步配参数cp .env.example .env cp .migpt.example.js .migpt.js打开.env必填就三处OPENAI_API_KEY你的密钥# 大模型服务的 API KeyOPENAI_MODELgpt-4o-mini# 模型名换国产模型时改这里OPENAI_BASE_URLhttps://api.openai.com/v1# 接国产模型时换成对应服务的 OpenAI 兼容端点以通义千问为例BASE_URL 换成它的兼容模式地址MODEL 换成 qwen 系列变量名原样保留其他都不用动。再打开.migpt.js重点改speaker配置下的四处userId: 小米ID# 不是手机号也不是邮箱去「个人信息-小米 ID」里查password: 账号密码# 和小米 ID 是同一个账号did: 小爱音箱Pro# 直接复制米家里的设备名称空格、大小写、错别字都会导致找不到设备ttsCommand: [5, 1]与wakeUpCommand: [5, 3]# 不同型号指令不同小爱音箱 ProLX06就填这组其他型号去 docs/compatibility.md 查指令参数怎么查去小米 MIoT 规范网站搜你的型号打开规格文档第四步启动pnpm run dev这条命令会同时加载.env和.migpt.js。想走 Docker 路线的话配好这两个文件后一条docker run -d --env-file .env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest也能起Windows 终端下记得把$(pwd)换成绝对路径。另外 MiGPT 是单实例单账号一台机器跑一个实例对应一个小米账号和一台音箱。想多开就再起一个容器、换一份配置。第五步确认跑通控制台打出 MiGPT 的 ASCII 横幅后面跟着「服务已启动」字样——登录、连设备、初始化数据库全过了。走到音箱前说小爱同学请介绍一下你自己。先听到让我先想想接着音箱用大模型的口吻回答你这就是跑通的标志。想试连续对话说小爱同学召唤傻妞进入唤醒状态后后面几轮提问不用每句都带小爱同学前缀。小爱音箱 Pro 可以观察顶部指示灯常亮就是它在听其他型号等我说完了的提示语播完停一两秒再追问。如果音箱没动静先看控制台有没有登录或设备报错日志显示都正常却没声音多半是ttsCommand和型号不匹配。小爱音箱大模型回复链路是怎么走通的一条完整问答数据流就是「输入→处理→输出」输入你说出小爱同学请解释一下黑洞。音箱把语音上报小米云端落进这台设备的对话列表。处理src/services/speaker/speaker.ts按固定间隔轮询这份对话列表发现新消息就丢给src/services/speaker/ai.ts。那里有一组按顺序匹配的指令以唤醒词wakeUpKeywords开头的消息进入连续对话模式以 callAIKeywords默认请你开头的判定为 AI 问题。判定通过后src/services/bot/conversation.ts把消息连同短期记忆、长期记忆一起组装进系统提示词再由src/services/openai.ts发给大模型。输出回答被切成小段经src/services/speaker/stream.ts逐段下发 TTS音箱边收边播。所以你能听到秒回的流式效果而不是干等一整段。配置里的ttsCommand、wakeUpCommand看着像天书其实就是 MIoT 指令编号前一个数是功能域后一个数是方法序号。两个值得知道的细节。第一因为轮询间隔在秒级原生小爱有时会抢答一句这个问题我还不会提问后也有一两秒的思考延迟。MiGPT 的应对是立刻播一段静音音频把原生回答盖过去——代价是偶尔能听出半秒抢话这是不刷机方案下的已知边界。第二每轮对话都会写进本地 SQLite短期记忆保留最近的上下文长期记忆留重要细节下次提问自动带上。越聊越懂你是真的数据也全在你自己机器上。两个高频场景速配换人设与换模型场景一给小爱立个人设需求让它不只是答题机器而是有个固定性格的角色。改哪.migpt.js里的bot.profile角色简介和systemTemplate回复规则。懒得改文件直接说小爱同学你是xxx你xxx运行中就能换。验证问它你叫什么名字回答应该完全入戏。场景二换国产大模型提速需求OpenAI 连不上或回答太慢。改哪.env里OPENAI_BASE_URL、OPENAI_MODEL、OPENAI_API_KEY三行换成通义千问或 DeepSeek 的值变量名保持不变。验证重启后问同样的问题对比日志里从提问到首句回答的时间差国内节点通常快不止一倍。MiGPT 常见报错速查表症状最可能原因一条修复70016登录验证失败userId 填成了手机号或邮箱改成「个人信息-小米 ID」里的数字找不到设备xxxdid 与米家中名称不一致复制米家设备名覆盖.migpt.js的 didLLM 响应异常 / Connection error国内网络连不上 OpenAIOPENAI_BASE_URL改国产模型或配HTTP_PROXY回答说到一半戛然而止该型号查不到播放状态.migpt.js里streamResponse改为 false都没解决的话拿报错原文去 issue 区搜一遍docs/faq.md 也收了绝大部分高频问题包括异地登录保护的完整处理流程。下一步跟进更新与参与社区想看看项目动态和计划中的功能通知事件、MIoT Agents、RAG翻 docs/changelog.md 和 docs/roadmap.md。你踩的坑、你型号的指令参数发一条 issue 就是最实在的贡献——兼容列表就是社区用户一个个补出来的。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考