1条命令让小爱音箱接入大模型MiGPT 完整部署与配置教程【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 这个智能音箱AI改造开源项目用一条 Docker 命令就能把现有的小爱音箱接入 ChatGPT、豆包等大模型。以“天空为什么是蓝色的”为例改造前它只会回一句“抱歉我暂时无法回答这个问题”改造后它能用大白话讲清散射原理再跟你追问聊上几轮——设备从执行固定指令的播放器变成了能连续对话的语音助手。 能力清单小爱音箱改造后多会的五件事开放域问答不再受限于固定指令集天文、地理、生活类开放问题都能接回答质量取决于你接入的模型。连续对话唤醒模式说一句“小爱同学召唤傻妞”进入 AI 模式后续提问无需每句都喊“小爱同学”。长短期记忆对话记录存入本地 SQLite 数据库问答时自动携带上下文聊得越久越连贯。角色定制bot/master两组字段即可设定人设让音箱拥有固定性格和说话方式。第三方音色可接入与豆包同源的火山 TTS 等服务声音不再只有小爱默认音色一种。 MiGPT 一键 Docker 部署从拿到代码到跑通的最短路径先明确设备边界MiGPT 支持大部分小爱音箱型号推荐小爱音箱 Pro实测体验最稳小度音箱、天猫精灵、HomePod 均不支持。服务本身跑在任意装了 Docker 的机器上即可家中有网线的旧电脑、NAS 或云服务器都行不需要与音箱处于同一局域网因为它走的是小米云端接口。从仓库克隆代码并把两个模板文件改名就完成了一半准备git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env cp .migpt.example.js .migpt.js接着把账号、密钥和模型信息填进这两个文件再用下面一条命令拉起容器--env-file加载环境变量-v挂载配置文件docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest启动成功后终端会打出 MiGPT 标志和“服务已启动”此时对着音箱说“小爱同学召唤傻妞”即可验证。如果你熟悉 Node.js 环境也可以不走镜像pnpm install pnpm db:gen pnpm devNode 方式下配置文件不会自动读取需手动加载环境变量并把.migpt.js的内容作为MiGPT.create的参数传入。Windows 终端跑 Docker 时命令里的$(pwd)需替换为配置文件绝对路径否则会挂载失败。⚙️ 配置文件核心字段新手最容易卡住的三个参数其余字段照抄默认值即可真正容易踩坑的是下面三个详细说明见 docs/settings.md。speaker.userId不是手机号也不是邮箱而是纯数字的小米 ID在小米账号“个人信息 → 小米 ID”里查看。填错必现登录失败。speaker.did必须与米家 App 里的设备名称逐字一致错别字音响/音箱、多余空格、大小写Pro/pro都会导致“找不到设备”。最稳妥的做法是直接复制米家中的名称。OPENAI_BASE_URL与OPENAI_MODEL接入通义千问、DeepSeek 等国产模型只需改这两个变量的值变量名保持不变国内网络直连 OpenAI 困难时这也是标准解法。speaker: { userId: 987654321, // 小米 ID password: 你的小米账号密码, did: 小爱音箱Pro, // 与米家设备名一致 }其余字段一句话带过ttsCommand、wakeUpCommand、playingCommand是 TTS 播报、唤醒、播放状态查询三类动作的机型专属指令号可在小米 IoT 规范站点home.miot-spec.com按型号查到后填入onEnterAI等提示语默认即可callAIKeywords/wakeUpKeywords关键词列表决定哪些话触发 AI、哪些话进入连续对话。️ 避坑清单三类高频问题的现象、原因与解法现象启动即报“70016登录验证失败”原因userId填成了手机号或邮箱或小米账号触发了异地登录安全校验。 解法确认改用小米 ID在服务所在的网络环境下用小米官网登录一次账号并手动通过安全验证等约 1 小时后再重启容器即可。现象启动报“找不到设备xxx”原因did与米家中的设备名不一致或 MiNA 与 MiOT 两套名称存在出入。 解法优先直接复制米家设备名仍不匹配时在.migpt.js中打开debug: true与enableTrace: true重启后从控制台“MiNA 设备列表”里找到miotDID填入did完成后记得关掉调试开关。现象AI 回答正常但音箱播一半就停或完全不发声原因ttsCommand/playingCommand与你的型号不匹配播报或播放状态查询用错了指令。 解法以型号 lx06小爱音箱 Pro为例在规范站点搜到型号后按页面动作/属性编号修改对应参数若改完仍读不完整句说明该机型无法查询播放状态只能关闭streamResponse流式响应保完整播报代价是连续对话功能失效。 两个值得深入的方向人设定制与本地化自定义人设与唤醒词除了bot.profile写死人设对话中直接说“小爱同学你是 xxx你 xxx”可以临时改角色wakeUpKeywords/callAIKeywords也能换成自己习惯的“召唤”说法交互方式完全由你定义。本地模型 第三方 TTSOllama、LM Studio 等本地模型服务自带 OpenAI 兼容接口把OPENAI_BASE_URL指向本地地址即可脱离云端音色方面可接火山 TTS 等第三方服务做法见 第三方 TTS 教程。一句话概括MiGPT 的价值就是把小爱音箱的对话通道接到了大模型上部署完成后你得到的是一台有记忆、能改人设、可换音色的语音助手。需要提醒的是项目方已宣布停止维护现有版本v4.2.0功能完整按当前文档使用即可。延伸阅读官方文档目录docs/核心服务源码src/services/【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考