MiGPT完整指南:五步把小爱音箱改造成专属AI语音助手 📅 发布时间:2026/9/14 7:53:11 👁 浏览次数: MiGPT完整指南五步把小爱音箱改造成专属AI语音助手【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 能把家里的小爱音箱接入 ChatGPT、豆包这类大模型让它从只会放歌的人工智障变成能唠嗑的 AI 语音助手。新手照着下面的步骤走一个下午就能跑起来。✅ 先核对好这 4 件事一台支持的小爱音箱。MiGPT 走的是小米 MIoT 开放接口小度、天猫精灵、HomePod 这类设备完全不适用小爱音箱 Pro 是完美运行最省心。动手前先对照兼容型号清单确认你的型号顺便记下它的指令参数后面配置要用。一个小米账号。要密码还要小米 ID——注意它不是手机号也不是邮箱在小米账号的个人资料页里查。服务要用这个身份登录并代为操作音箱填错就启动失败。一个大模型的 API Key。OpenAI、通义千问、DeepSeek、Moonshot凡是兼容 OpenAI 接口的都能用这是音箱的大脑没有它没法说话。一台装了 Docker 的电脑Node 16 也可以。有个好消息MiGPT 走云端接口不用和音箱在同一个局域网放家里旧笔记本或树莓派上都能干活。 启动服务让第一条对话跑通先把原理说透出问题时你才知道该往哪查MiGPT 不改音箱固件它用你的小米账号登录轮询小米云端上你和小爱的对话记录发现新消息就调大模型生成回答再把合成语音播回音箱。所以问题基本只出在三处——登录、找设备、连大模型。第一步克隆项目并检查示例配置git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt你会看到项目目录成功的标志是里面躺着.env.example和.migpt.example.js两个示例文件后面要把它们分别改名成.env和.migpt.js。第二步填大模型密钥把.env.example重命名为.envmv .env.example .env然后填入你的密钥。用国内模型时把接口指向它的 OpenAI 兼容地址即可变量名一个都不用改OPENAI_MODELgpt-4o-mini OPENAI_API_KEY你的密钥 # 用通义千问等国内模型时把接口指向其 OpenAI 兼容地址 # OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1第三步填小米账号和音箱名把.migpt.example.js重命名为.migpt.js重点改speaker下三处userId小米 ID、password、did。did 最稳的做法是打开米家把音箱的设备名一字不差地复制过来——多一个空格、大小写写错、音箱打成音响都会直接启动失败。然后从兼容表里查你型号的ttsCommand和wakeUpCommand填进去比如小爱音箱 Pro 是[5,1]和[5,3]照抄对应型号那一行就行。第四步一条 Docker 命令启动配置文件会挂载进容器改完配置重启容器即可生效docker run -d --name migpt --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest docker logs -f migpt这里有个小坑Windows 的 PowerShell 和 cmd 里$(pwd)不生效必须把两个路径换成绝对路径比如D:/hello/mi-gpt/.env。如果你是 Node 开发者也可以本地跑pnpm install装依赖、pnpm build构建、pnpm dev启动建议 Node 20 以上。第五步说一句话验证成功控制台打出 MiGPT 版本号并出现服务已启动…字样就说明服务活着了。走到音箱前说小爱同学请问地球为什么是圆的它会先播报让我先想想然后用大模型的答案回答你。注意一个规则只有以callAIKeywords默认请、你开头的消息才会被交给 AI没先喊小爱同学直接说话它是收不到的。️ 把 3 个最有意思的配置玩起来调教小爱的人设在哪配.migpt.js里bot名字、性格简介和master你的名字、简介以及顶部的systemTemplate。怎么验不用重启直接说小爱同学你是蔡徐坤。你是一名歌手喜欢唱跳rap她立刻换戏说我是xxx我xxx还能更新她对你的印象。模板变量{{botName}}、{{messages}}这些怎么被替换详见系统 Prompt 说明。什么效果配合默认开启的长短期记忆她记得你们聊过什么越聊越像一个认识你的角色。开启连续对话的唤醒模式在哪配.migpt.js的wakeUpKeywords默认打开、进入、召唤、exitKeywords并把streamResponse设为true。怎么验说小爱同学召唤傻妞进入 AI 模式之后每一句都不用再喊小爱同学等她说我说完了再问下一句说退出傻妞离开。什么效果像开了一段连续对话体验接近刷了机的效果。两个注意点连续对话依赖音箱能正确查询播放状态不是所有型号都支持看兼容表里的streamResponse列不支持就关掉如果唤醒词被当成歌名播放唤醒这种词容易中招换个词就好。换掉默认机械音用上第三方 TTS在哪配.env里填TTS_BASE_URL一个 TTS 服务地址可参考仓库里提到的 MiGPT-TTS 项目自建.migpt.js里把speaker.tts改成custom具体步骤看仓库 docs/tts.md。怎么验说小爱同学把声音换成xxx声音当场切换。什么效果告别小爱默认音色还能绕开小米 TTS 对敏感词的拦截。 用 5 种办法修好高频坑控制台提示70016登录验证失败原因多数不是密码错是userId填成了手机号或邮箱。解法去小米账号资料页查小米 ID改完重启容器。另一种是账号触发异地登录保护——在运行 MiGPT 的同一网络下用浏览器登录一次小米账号、通过安全验证等约一小时再试。提示找不到设备xxx原因did和米家里的设备名对不上空格、大小写、错别字都会踩雷。解法从米家复制原文实在不行把.migpt.js里debug和enableTrace都设为true启动日志的MiNA 设备列表里能找到miotDID填它。多台音箱的话跑多个配置不同的 docker 容器即可MiGPT 本身是单实例。控制台有 AI 回复音箱却不发声原因各型号的 TTS 指令不一样ttsCommand的示例值不一定对得上你的设备。解法到 MIoT 开放平台搜你的音箱型号比如 lx06找到 play-text 动作的 SIID 和 AIID 拼成指令例如[5,1]填入重启。报LLM 响应异常 Connection error原因国内网络连不上 OpenAI。解法三选一.env里填HTTP_PROXY走代理换第三方 OpenAI 反向代理并改OPENAI_BASE_URL直接换通义千问、DeepSeek 等国内模型。看到 401 是密钥无效看到 404 说模型不存在通常是账号没权限用该模型换个便宜档的模型名就行。回答说到一半戛然而止原因型号查不到播放状态连续对话把语音拦腰截断。解法查playingCommand播放状态属性的 SIID 和 PIID填上还不行就把streamResponse设为false代价是放弃连续对话。MiGPT 的整个流程其实就是克隆、改两个配置文件、跑一条 docker 命令。跑通之后家里任何人问音箱一句话得到的都是大模型的答复这种旧物新生的成就感值得你今晚就动手试一把。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考