如何用 MiGPT 快速把小爱音箱接入 ChatGPT4步部署完整攻略【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt对着小爱音箱喊小爱同学请问地球为什么是圆的它却只能给你来一句抱歉我没太听清。MiGPT 做的事很简单把你的小爱音箱接到 ChatGPT、豆包这类大模型上让音箱变成能问答、能角色扮演、能连续对话的语音助手。你动嘴提问它语音作答全程不用碰手机。先看看效果跑通之后你手里这台音箱至少多了这 5 个能力 AI 问答小爱同学请问 xxx直接得到大模型的回答 角色扮演在配置文件里给小爱起名字、写人设它可以变成任何角色陪你聊天 连续对话说小爱同学召唤傻妞进入唤醒模式之后提问不用再重复唤醒词 长短期记忆对话上下文保存在本地数据库里它记得之前聊过什么 自定义音色接上第三方 TTS 服务换掉小米自带音色从零到跑通一共 3 步克隆仓库、配两个文件、执行一条 Docker 命令。顺利的话 30 分钟内搞定最耗时的其实是申请模型 API Key。开始之前动手前先备齐 4 样东西缺一样后面都会卡住准备项要求说明音箱小爱音箱 Pro 优先完整兼容列表见 docs/compatibility.md小度、天猫精灵不支持小米账号小米 ID 密码ID 是账号中心「个人信息」里的那串数字不是手机号或邮箱大模型OpenAI 兼容格式的 API KeyOpenAI、通义千问、DeepSeek 等都可以服务器装好 Docker或 Node.js 16音箱和服务器不用同一局域网走的是 MIoT 云端接口⚠️ 易错提醒配置里的userId填错格式是70016 登录验证失败的头号原因开跑前先去账号中心把小米 ID 抄下来。跑通第一步的最短路径第 1 步拿代码准备配置模板git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env cp .migpt.example.js .migpt.js第 2 步填 .env 里的模型信息OPENAI_MODELgpt-4o-mini OPENAI_API_KEYsk-xxxxxxxx # OPENAI_BASE_URLhttps://api.openai.com/v1国内模型只需改这三个值的指向环境变量名不变比如通义千问把OPENAI_BASE_URL填成它的兼容接口地址。第 3 步填 .migpt.js 里的账号和设备改三处userId小米 ID、password、did米家 App 里显示的设备名称注意空格和大小写。再对照 docs/compatibility.md 确认你型号的ttsCommand小爱音箱 Pro 是[5, 1]。第 4 步启动并验证docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest 省时间技巧Windows 终端里$(pwd)不生效把路径换成绝对路径比如D:/hello/mi-gpt/.env。docker logs -f mi-gpt你应该看到什么日志依次出现 Mi Service 登录成功、MiNA 设备列表里面有你的音箱、启动完成。然后对音箱说小爱同学请问地球为什么是圆的它会先说让我先想想之类的提示语再开始播报 AI 的回答。听到回答就算跑通了。Node.js 开发者也可以不用 Dockernpm install mi-gpt后在代码里调用MiGPT.create传入 speaker 参数即可启动配置需要手动写进代码。最常碰到的配置点全文配置集中在.env和.migpt.js两个文件挑 5 个对体验影响最大的讲1. callAIKeywordsAI 触发词是什么哪些消息前缀会触发 AI 回答。怎么改.migpt.js里的数组默认[请, 你, 傻妞]。改完什么效果只有小爱同学请 xxx这种句式才会走 AI加自己的词就能让更多说法命中。2. wakeUpKeywords streamResponse连续对话是什么前者是进入唤醒模式的词后者是连续对话总开关。怎么改wakeUpKeywords: [打开, 进入, 召唤]同时把streamResponse设为true。改完什么效果说小爱同学召唤傻妞后可以直接连续提问不用每次都喊唤醒词。 冷知识这个连续对话是靠轮询消息列表实现的实验性功能并非音箱固件自带的效果因型号而异不稳定的机型建议关掉。3. systemTemplate / bot.profile人设与提示词是什么系统 Prompt 模板和角色人设决定小爱扮演谁、怎么说话。怎么改编辑.migpt.js里的bot、master字段和systemTemplate模板里预留了聊天历史、长短期记忆等占位变量。改完什么效果可以调成贴心闺蜜或严肃老师也能控制上下文带多少进模型。4. checkInterval连续对话停顿感是什么连续对话模式下检测播放状态的间隔默认 1000 毫秒。怎么改在.migpt.js里调成500最低值。改完什么效果小爱多句回答之间的停顿更短。5. TTS 音色是什么默认用小米自带引擎朗读。怎么改tts设为custom并在.env填TTS_BASE_URL教程见 docs/tts.md。改完什么效果语音说小爱同学把声音换成 xxx就能切换音色。踩坑自查前 5 个高频故障对照现象直接找解法现象解法提示70016登录验证失败或触发异地登录保护前者是userId用了手机号/邮箱换成小米 ID后者先在运行 MiGPT 的同一网络下登录小米官网过安全验证等约 1 小时再试仍不行就先本地跑通、导出.mi.json再挂载到容器/app/.mi.json提示找不到设备xxxdid和米家设备名不一致空格、大小写、响/箱错别字都会中招打开debug: true和enableTrace: true重启从日志的 MiNA 设备列表里抄miotDID填进去控制台有 AI 回复音箱却没声音ttsCommand和你的型号不匹配按 docs/compatibility.md 对照修改比如 Xiaomi 智能音箱 Pro 是[7, 3]而非[5, 1]回答说到一半戛然而止部分型号不支持默认方式查播放状态按型号表配置playingCommand如小爱音箱 Play 2019 款为[3, 1, 1]仍不行说明设备不支持查询只能关streamResponse换完整句子输出提示LLM 响应异常 Connection error国内网络访问不了 OpenAI在.env加HTTP_PROXYhttp://127.0.0.1:7890或干脆换成通义千问、DeepSeek 等国内模型再往前一步 换音色搭一个自己的 TTS 服务比如接火山引擎接口tts设为custom并配置TTS_BASE_URL细节在 docs/tts.md。️ 本地大模型装 Ollama 或 LM Studio它们自带 OpenAI 兼容 API把OPENAI_BASE_URL指向本机地址即可问答全程不出内网。 多设备多账号MiGPT 单实例只服务一台音箱管理多台设备就开多个容器各自挂一套.env和.migpt.js。MiGPT 的价值一句话用小米开放的 MIoT/MiNA 接口不刷机、不加硬件把普通小爱音箱变成大模型语音助手。README 顶部已注明项目进入停止维护状态功能整体稳定想查更新历史看仓库里的docs/changelog.md即可。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考