MiGPT 快速指南20分钟把小爱音箱接入大模型改造成专属语音助手【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt“小爱同学乾隆是谁”——它给你放了一首歌。这台“人工智障”在客厅吃灰三年该升级了。别急着换设备跟着本文操作约20分钟就能让旧的小爱音箱接上大模型变成一个会聊天、有记忆、有人设的AI语音助手。MiGPT仓库名mi-gpt是一个把小爱音箱接入 ChatGPT、豆包等大模型的开源项目支持 AI 问答、角色扮演、长短期记忆和自定义 TTS 音色。本文只走一条最短路径Docker 一键部署先跑起来再懂原理最后调配置。MiGPT 最快安装步骤Docker路径第1步获取代码准备两个配置文件克隆仓库到本地再复制两个配置模板git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env cp .migpt.example.js .migpt.js✅成功标志ls能看到.env和.migpt.js前者是“大模型的门禁卡”后者是“小爱的账号钥匙”。第2步填 .envAI 服务的钥匙OPENAI_MODELgpt-4o-mini OPENAI_API_KEYsk-proj-xxxxxxxx变量名保持OPENAI_前缀不变值可以换成通义千问、Kimi 等兼容模型的配置同时改OPENAI_BASE_URL。 ⚠️ 密钥相当于 AI 服务的门禁卡别分享给别人、别提交到代码仓库国内网络直连 OpenAI 失败时再加一个HTTP_PROXY代理变量。✅成功标志密钥是一长串字母数字去对应平台后台能看到状态有效。第3步填 .migpt.js小爱账号与设备// .migpt.js只需改这三处 speaker: { userId: 123456789, // 小米ID不是手机号或邮箱 password: 你的账号密码, did: 小爱音箱Pro, // 米家APP里的设备名一字不差 }⚠️ 最多人翻车在userId它是小米官网「个人信息 → 小米 ID」里的数字编号填成手机号必报“70016登录验证失败”。✅成功标志did与米家 APP 里显示的设备名称逐字一致含空格和大小写。第4步一条 Docker 命令启动docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest⚠️ Windows 终端里$(pwd)无效要换成配置文件绝对路径国内拉取镜像慢就先给 Docker 配镜像源。✅成功标志docker ps | grep mi-gpt状态为 Up日志里出现「服务已启动」并且能看到 AI 回复文本。第5步唤醒验证对着音箱说小爱同学请告诉我地球为什么是圆的。✅成功标志小爱先播提示语随后用大模型的答案作答再问“小爱同学你喜欢我吗”它能带人设地回应。小爱音箱接入大模型的工作原理别急着看架构把它想成一个在幕后打工的**“翻译官调度员”**。你对着小爱说话问题会上传到小米云端。MiGPT 不断轮询云端对话列表相当于查通话记录一发现新问题就交给大模型模型生成的文字再通过小米开放接口MIoT下发给音箱念出来。整条链路都走小米开放接口所以MiGPT 不需要和小爱音箱在同一局域网也不用刷机部署在任意一台服务器或 NAS 上就行。“与大模型对话”这一环就是下面这张图里的过程你的提问进入对话模型生成回答这段文字最终由音箱朗读和原厂小爱相比核心改进在这维度原厂小爱接入 MiGPT 后回答内容固定问答固定话术大模型自由问答唤醒方式每句都要“小爱同学”唤醒模式可连续对话人设官方固定自定义人设记长短期音色小米自带 TTS可接第三方 TTSMiGPT 配置说明必配 / 常配 / 选配所有配置都集中在.env和.migpt.js两个文件里。必配缺了服务跑不起来配置项作用示例值改错会怎样OPENAI_API_KEYAI 服务门禁卡sk-proj-xxx报 401AI 不回复OPENAI_MODEL用哪个模型gpt-4o-mini报 404「model does not exist」speaker.userId小米 ID12345678970016 登录失败speaker.password小米账号密码abcd123470016 登录失败speaker.did音箱的米家名或 ID小爱音箱Pro报「找不到设备」ttsCommand“朗读文本”指令[5, 1]控制台有回复音箱不出声wakeUpCommand唤醒音箱指令[5, 3]音箱唤醒失败、连续对话失效ttsCommand和wakeUpCommand每个型号不同查规格文档即可在搜索框输入你的型号如 LX06打开「规格」看方法表——play-text对应ttsCommandwake-up对应wakeUpCommand。下面这张红箭头直接标出了两条指令的位置[5, 1]是“朗读文本”[5, 3]是“唤醒” 避坑项目目前已停止维护遇到问题先搜 docs/faq.md高频坑大多已有现成答案。常配跑通后再调配置项作用示例值改错会怎样OPENAI_BASE_URL模型服务地址换国产模型必改https://.../v1地址不对直接 404 连不上callAIKeywords触发 AI 回答的关键词[请, 傻妞]不以这些词开头的提问不触发 AIonAIAsking/onAIReplied回答前后提示语[让我先想想]设为[]则关闭提示streamResponse是否开启连续对话true播放状态查不准的型号必须设false选配调手感/排障用playingCommand如[3, 1, 1]查询播放状态的指令回复总是戛然而止时启用。checkInterval如500播放状态检测间隔毫秒数调小可让回复停顿更短。tts/TTS_BASE_URL第三方 TTS 引擎与地址默认xiaoai用小米自带。debug如true详细日志开关排障时打开平时关掉。MiGPT 进阶玩法连续对话与自定义音色玩法一唤醒模式不用每句都喊“小爱同学”// .migpt.js speaker: { streamResponse: true, wakeUpKeywords: [召唤, 打开], exitKeywords: [关闭], onEnterAI: [你好我是傻妞很高兴认识你], }说一句“小爱同学召唤傻妞”就进入 AI 模式之后直接提问它直接答省掉唤醒词说“关闭傻妞”退出。注意时机等它念完“我说完了”过 1-2 秒再问下一句Pro 型号顶部指示灯常亮时说明它在听。上图是规格文档里的playingCommand连续对话回复总被截断时按你的型号查到类似[3, 1, 1]的指令填进去。玩法二换人设换音色把小爱调教成你的“傻妞”// .migpt.js bot: { name: 傻妞, profile: 性别女乖巧可爱喜欢搞怪爱吃醋 }, master: { name: 陆小千, profile: 性别男善良正直 }, speaker: { tts: custom, switchSpeakerKeywords: [把声音换成] },在.env里把TTS_BASE_URL指到你的第三方 TTS 服务火山引擎、本地 ChatTTS 都支持音色就从官方音变成真人音色。之后说一句“小爱同学把声音换成灿灿”即可切换人设也能临时改——“小爱同学你是蔡徐坤”下一句它就入戏回答。 成本提醒大模型 API 按量计费连续对话和长记忆都会多烧 token不用的时候docker stop掉服务更省钱。MiGPT 常见问题自查手册编号现象最可能原因一条排查命令1启动报「70016登录验证失败」账号密码错或userId填了手机号cat .migpt.js \| grep -A 2 userId2报「找不到设备xxx」did与米家不一致大小写/空格docker logs mi-gpt \| grep 设备列表3「LLM 响应异常 Connection error」国内直连 OpenAI 失败没配代理curl -I https://api.openai.com4「401 Invalid Authentication」密钥无效或.env没生效grep OPENAI_API_KEY .env5控制台有回复音箱不出声ttsCommand与型号不符docker logs mi-gpt \| grep -i tts6连续对话回复戛然而止播放状态查不到缺playingCommand按型号在规格文档查指令值两个通用排障习惯① 小爱正在放音乐或讲笑话时先让它暂停再对话② 说话没反应直接“小爱同学xxx”重新唤醒即可。资源索引全部参数详解docs/settings.md常见问题登录/播放/网络docs/faq.md支持的型号与指令参数表docs/compatibility.md工作原理docs/how-it-works.md第三方 TTS 接入教程docs/tts.md核心源码src/services/现在就可以重启服务对它说一声“小爱同学你喜欢我吗”——如果听到的是带人设的回答这台吃灰三年的音箱就正式下班了。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考