3步把小爱音箱改造成AI语音助手MiGPT完整快速配置指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt家里那台音箱除了定闹钟、放音乐还能干嘛MiGPT 是一个免费工具把小爱音箱接入 ChatGPT、豆包这类大模型让普通音箱变成能聊天的专属语音助手说一句小爱同学请xxxAI 就用语音实时回答。下面从装环境到跑出第一次语音对话一步步带你走完每个参数都讲清楚新手也能一次搞定。30秒看懂MiGPT 本质是个中间桥一边听小爱音箱里的你的语音另一边把内容丢给大模型再把答案用语音播回音箱。当前 4.2.0 版本把最常用的三件事都做稳了语音唤醒即问即答不用掏手机张嘴就有回应、大模型自由切换OpenAI、豆包、通义千问都能接、人设完全自定义它是傻妞还是豆包你说了算。用法一句话概括配好文件、启动服务、语音唤醒。✅ 第一次对话跑通的最短路径第1步装环境、拉代码需要 Node.js 16 及以上用 node -v 看版本外加 npm 或 pnpm 任一包管理工具。在终端执行下面三行下载代码并装依赖git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm installinstall 跑完没有报错这一步就算齐了。第2步确认音箱型号和名字MiGPT 支持大部分小爱音箱其中小爱音箱 Pro 最稳。先翻一下兼容型号清单看看你的型号在不在、要不要特殊参数。再去米家 App 里抄两样东西音箱的名字也就是 did设备ID这台音箱的唯一标识和设备指令参数指令可以去 MIoT 设备规范平台按型号查。按型号查询音箱设备规格和指令的界面第3步建两个配置文件仓库根目录有两个示例配置文件先复制成正式文件cp .migpt.example.js .migpt.js cp .env.example .env先编辑 .env它是 AI 相关参数的大本营。填三样密钥key证明你有权限调用模型服务的 API 密钥、模型名、接口地址。默认按 OpenAI 官方接口写OPENAI_API_KEY你的密钥 OPENAI_MODELgpt-4o-mini OPENAI_BASE_URLhttps://api.openai.com/v1API 密钥获取界面示意密钥拿到手之后注意保管第4步填最关键的5个参数再编辑 .migpt.js重点看 speaker 段里这几项speaker: { userId: 你的小米ID, password: 你的小米密码, did: 小爱音箱Pro, }userId 填小米ID在个人信息-小米ID里看不是手机号或邮箱did 就是第2步抄的音箱名或设备ID空格和大小写都要对上ttsCommandTTS语音合成指令默认 [5,1]和 wakeUpCommand设备唤醒指令默认 [5,3]管语音播放和唤醒多数型号不用改第5步启动并喊出第一句最后执行pnpm start启动服务控制台打印出服务启动相关日志就代表跑起来了。接下来对着音箱说小爱同学请xxx比如地球为什么是圆的小爱同学你xxx比如你喜欢我吗小爱同学召唤xxx直接进 AI 模式MiGPT 启动成功后的控制台界面显示服务状态和交互日志⚙️ 配置文件参数速查全部参数以官方参数设置文档为准平时最常碰的就下面这几个参数所在文件填什么改了会怎样userId.migpt.js小米ID非手机号/邮箱填错就连不上音箱password.migpt.js小米账号密码同上did.migpt.js音箱名或设备ID对不上就找不到音箱ttsCommand / wakeUpCommand.migpt.js默认 [5,1] / [5,3]不同型号指令不同照型号改OPENAI_API_KEY.env模型服务密钥缺失时 AI 不响应OPENAI_MODEL.env模型名如 gpt-4o-mini决定谁在替你回答OPENAI_BASE_URL.env接口地址一般 /v1 结尾指向别家即完成模型切换TTS_BASE_URL.env第三方TTS服务地址可选用于换音色wakeUpKeywords / exitKeywords.migpt.js唤醒、退出关键词决定你用什么话召唤/退出bot.name.migpt.js助手名字改它对自己的称呼 选一个适合你的模型/服务项目的 .env 注释里写明了 OpenAI 风格的接口都兼容所以基本有三种选法OpenAI 官方.env 默认配置直接用gpt-4o-mini 便宜快gpt-4o 更稳。需要网络能直连官方接口。国产大模型豆包、通义千问、DeepSeek、MoonShot 等把 OPENAI_BASE_URL 指到对应模型的兼容接口地址再换密钥和模型名就行代码一行不用动。用通义千问还能加一行 QWEN_ENABLE_SEARCHtrue让它答题时参考联网搜索结果。本地模型自己有部署了 OpenAI 风格 API 的 LLM同样可以接进来。给大多数人的推荐OPENAI_BASE_URL 指到国产模型的兼容接口连接稳定、成本低中文语境也更好。模型选择界面换不同接口和密钥即可切换 AI 服务 把它调成你自己的换个灵魂人设最立竿见影的一项。AI 叫什么名字、什么性格写在 bot.name 和 bot.profile 里bot: { name: 豆包, profile: 女活泼开朗喜欢用表情符号 }换句唤法唤醒词默认请/你开头会回答召唤开头进 AI 模式。想改成叫豆豆也行直接改关键词wakeUpKeywords: [召唤, 叫], exitKeywords: [退出, 拜拜]连续对话连着问不用每次喊默认一问一答。把 streamResponse 设为 true 后 AI 会持续听你说话30 秒没反应exitKeepAliveAfter 的取值自动退出。连续对话期间音箱播放状态是轮询检测的如果长回答被中途掐断可以试试调大 checkTTSStatusAfter。连续对话依赖音箱播放状态检测参数在此调整嫌小爱音色出戏的话再接一个第三方 TTS 服务.env 填 TTS_BASE_URL具体步骤见第三方TTS文档。⚠️ 避坑速查连不上音箱多半是 userId 填成了手机号或邮箱或 did 和米家里的名字对不上。改成小米ID、did 逐字对齐还不行就临时打开 enableTrace 看真实设备 did。AI 有回答但音箱没声ttsCommand 和你的型号不匹配。去 MIoT 设备规范平台查对应指令替换掉下面这张对照表可以帮你查功能对应的指令码设备指令对照表TTS 播放等功能对应哪组指令码一查即知对话被掐断、连续对话失灵你的型号可能查不准播放状态先关掉 streamResponse或调大 checkTTSStatusAfter 再试。AI 始终不响应查密钥是否有效、接口地址是否正确再看控制台报错。基本就是 .env 里 OPENAI_API_KEY 和 OPENAI_BASE_URL 二选一的问题。改了配置不生效如果你用 Docker 启动改完配置必须重启容器仍不生效就删掉旧实例重新创建。更多疑难杂症翻一翻官方常见问题文档基本都有答案。配置完你家里的小爱音箱就不只是个闹钟机器了语音一喊AI 应声人设、记忆全是你定的。想再往深处改参数或动代码去看开发文档——两个配置文件、一条启动命令这就是全部。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考