30分钟让小爱音箱接入ChatGPT：配置、启动与踩坑全记录

30分钟让小爱音箱接入ChatGPT配置、启动与踩坑全记录【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt你对着小爱音箱问今天适合穿什么它回你抱歉我暂时还不能回答这个问题。传统音箱只会执行固定指令集问题稍复杂一点就哑火。MiGPT 就是为这个短板准备的一个跑在 Docker 里的中间服务轮询小米云端接口把你说过的话丢给 ChatGPT 或豆包等大语言模型LLMLarge Language Model即大语言模型再把回答用音箱的 TTS语音合成播出来。等于给小爱音箱换了个大脑声音还是原来的小爱。最短路径一条 Docker 命令跑通跑通只需要两个配置文件加一条命令。先拿代码git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env cp .migpt.example.js .migpt.js.env填模型侧的三样东西OPENAI_MODELgpt-4o-mini OPENAI_API_KEYsk-xxxxxxxxxxxxxxx # OPENAI_BASE_URLhttps://api.openai.com/v1.migpt.js填设备侧小米 ID、账号密码、音箱名称did要照抄米家 App 里的设备名空格和大小写都得一致。注意小米 ID 不是手机号也不是邮箱去小米官网「个人信息」页查。然后启动全程大约 5 分钟docker run -d --env-file $(pwd)/.env \ -v $(pwd)/.migpt.js:/app/.migpt.js \ idootop/mi-gpt:latestWindows 终端下$(pwd)取不到路径要换成.env和.migpt.js的绝对路径这一点官方 FAQ 里专门写了。.migpt.js 里 6 个必须懂的参数参数作用建议值speaker.userId小米账号的数字 ID小米官网「个人信息」里查到的 IDspeaker.password小米账号密码与小米官网登录一致speaker.did音箱名称或设备 ID照抄米家 App 中的名称ttsCommand让音箱朗读文字的 MIoT 指令编号小爱音箱 Pro 为[5, 1]wakeUpCommand唤醒音箱的指令编号小爱音箱 Pro 为[5, 3]callAIKeywords以这些词开头的消息才调用 AI[请, 你, 傻妞]ttsCommand和wakeUpCommand是每个型号一套的指令编号。查法到 MIoT 规格站点搜你的设备型号找到规格页AIID 列的数字拼起来就是参数值——[5, 1]表示 SIID 5 的 AIID 1。型号拿不准就去 docs/compatibility.md每个兼容型号都列好了这四个参数照抄最稳。启动后看到什么才算成功终端先打印 MiGPT 艺术字接着两行日志Speaker ✅ 服务已启动...之后每次交互都会追加一行带图标的记录。验收标准分两步控制台出现服务已启动且docker ps里容器是 Up 状态说明服务侧通了。对音箱说小爱同学请问地球为什么是圆的听到让我先想想请稍等这是onAIAsking提示语随后是模型回答最后以我说完了还有其他问题吗收尾说明全链路通了。如果控制台有 AI 回复但音箱不出声十有八九是ttsCommand查错型号了。小爱音箱接入 AI 后的三种真实用法用法一普通问答。每句话都以小爱同学开头且命中callAIKeywords里的词才会走 AI你说小爱同学请问红烧肉该先焯水还是先煎它答提示语后建议先煎。把肉块冷水下锅焯水去腥再煎到表面金黄……我说完了还有其他问题吗用法二连续对话。说小爱同学召唤傻妞wakeUpKeywords命中就进入 AI 模式之后每句话都不用再说小爱同学直接问就行说退出傻妞或沉默超过exitKeepAliveAfter配置的 30 秒自动退出。用法三角色定制。.migpt.js里的bot.profile和master.profile是人设字段systemTemplate把它们拼进系统提示词。模板自带角色扮演的完整提示词结构含聊天历史、短期记忆、长期记忆四个上下文区块你只想改性格的话动bot.profile那一段就够。改造前后对比一下对比项原生小爱同学接入 MiGPT 后天空为什么是蓝色固定百科式短答模型自由发挥可追问人设固定的小爱bot.profile自定义连续追问每次都要重新唤醒唤醒模式下免唤醒音色小爱 TTS可换第三方 TTS 引擎需要提醒MiGPT 只支持单实例运行多账号或多台设备要各起一个容器米家设备控制开关灯这类还是 roadmap 上的功能目前别指望。踩坑记录坑一提示70016登录验证失败现象容器启动即报错服务起不来。 原因userId填了手机号或邮箱小米 ID 是纯数字在「个人信息」页查。 解法改成正确的小米 ID若触发异地登录保护在同一网络下登录小米官网过安全验证约 1 小时后重试。坑二提示找不到设备xxx现象登录成功但初始化 Mi Services 失败。 原因did与米家中设备名不一致空格、大小写、错别字音响写成音箱都会导致。 解法直接复制米家里的名称名称和 MIoT 侧不一致时把debug和enableTrace打开从日志的 MiNA 设备列表里找miotDID填进去查完记得关掉。坑三LLM 响应异常 Connection error现象服务在跑一问就报网络错。 原因国内网络直连 OpenAI 不通。 解法.env里配HTTP_PROXY代理或改接兼容 OpenAI SDK 的国内模型通义千问、DeepSeek 等只需改OPENAI_BASE_URL和OPENAI_MODEL也可以本地跑 Ollama 再填本地地址。坑四回答总是说到一半戛然而止现象长回答被截断。 原因部分型号查不到播放状态连续对话无法判断音箱是否已播放完毕。 解法按型号在规格站查playingCommand填上确实查不到的型号只能把streamResponse关掉换完整回答代价是连续对话失效。MiGPT 的核心就是两个配置文件加一条 Docker 命令剩下的功夫基本花在查指令编号和排错上。参数逐项说明在 docs/settings.md上面的坑大多能在 docs/faq.md 里查到原始讨论想理解它怎么轮询小米接口可以直接翻 src/services/ 目录的源码先看通再动systemTemplate不迟。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考