4步把小爱音箱接入大模型MiGPT 部署与配置教程【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt晚上回家你随口问小爱同学今晚适合跑步吗它不再念出一段干巴巴的百科答案而是结合你的上下文用自然口语回你一句看你状态跑个半小时刚好记得补水。这就是 MiGPT 做的事情把小爱音箱接入 ChatGPT、豆包等大模型让音箱的语音回复背后换成真正的大模型推理。整个过程不需要刷机一条 Docker 命令就能跑起来。它是什么小爱音箱和大模型之间的语音桥MiGPT 是一个开源项目定位很单纯充当小爱音箱和大语言模型之间的中间层。它轮询小米开放接口拿到你对小爱说的内容把文本交给配置好的大模型再将回答通过音箱的 TTS 指令播出来。一句话概括原理把音箱的语音请求转发给大模型再把回答播回来。你不需要改动音箱固件也不要把 MiGPT 和小爱音箱放在同一局域网——它走的是云端接口部署在任何一台能联网的机器上都可以。动手前确认型号兼容与运行环境MiGPT 只支持小米系的小爱音箱小度、天猫精灵、HomePod 等其他品牌设备没有适配计划。先确认你的设备是否在兼容清单里运行体验较好支持连续对话小爱音箱 ProLX06、小米 AI 音箱第二代L15A、小爱智能家庭屏 10X10A、Xiaomi Sound ProL17A等可正常运行关闭连续对话小爱音箱 Play 增强版L05C、小爱触屏音箱LX04、小爱音箱 miniLX01等完全不支持小米小爱音箱 HDSM4、小米小爱蓝牙音箱随身版具体型号对应的 TTS 指令、唤醒指令参数可以查仓库内的 docs/compatibility.md。环境方面只需要两样一台能跑 Docker 的机器树莓派、NAS、云服务器均可或者 Node 16 环境一个可用的大模型 API KeyOpenAI、通义千问、DeepSeek 等兼容 OpenAI SDK 的服务另外提醒一点音箱不能是共享设备小米账号也不能处于异地登录风控状态否则启动会失败。部署Docker 单命令启动与源码备选先克隆项目并把两个模板文件复制为实际使用的配置文件git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .migpt.example.js .migpt.js cp .env.example .env配置好这两个文件后下一节讲细节Docker 方式只需一条命令docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latestWindows 终端下$(pwd)不生效把两处路径换成D:/xxx/mi-gpt/.env这样的绝对路径即可。备选方案是源码运行适合想改代码的开发者pnpm install # 安装依赖并初始化数据库 pnpm dev # 开发模式启动关键配置.migpt.js 与 .env 逐字段讲解.migpt.js管的是音箱这一端.env管的是大模型那一端。最关键的字段如下。设备与账号.migpt.jsexport default { speaker: { // 小米 ID注意不是手机号或邮箱在账号「个人信息」-「小米 ID」处查看 userId: 你的小米ID, // 小米账号密码 password: 你的密码, // 设备名称或 did必须与米家 APP 中完全一致含空格、大小写 did: 小爱音箱Pro, // TTS 指令按你的型号在 miot-spec 查对应值LX06 为 [5, 1] ttsCommand: [5, 1], // 设备唤醒指令LX06 为 [5, 3] wakeUpCommand: [5, 3], }, };大模型接入.env# 模型名称按你的服务商填写如 gpt-4o-mini、qwen-turbo OPENAI_MODELgpt-4o-mini # API 密钥占位符替换成你的真实密钥 OPENAI_API_KEYsk-your-api-key-here # 服务商接口地址OpenAI 官方或各厂商 compatible 地址均可一般以 /v1 结尾 # OPENAI_BASE_URLhttps://api.openai.com/v1两个容易踩的坑did写错一个字就会提示找不到设备OPENAI_BASE_URL填错或不配会导致请求 404。不同模型的接法差异在 docs/faq.md 里有说明。进阶玩法记忆、唤醒模式与自定义音色基础功能跑通后这几项配置能让体验明显不同。长短期记忆MiGPT 自带基于本地数据库的记忆系统对话中它会把短期细节和长期偏好写入 src/services/bot/memory/ 对应的存储后续对话时拼进提示词。默认开启无需额外配置想要控制容量可在systemTemplate中调整携带的记忆范围。唤醒模式连续对话不用每句话都喊小爱同学。在speaker下配置三组关键词speaker: { // 消息以这些词开头时调用 AI 回复 callAIKeywords: [请, 你, 傻妞], // 以这些词开头时进入唤醒状态之后可直接提问 wakeUpKeywords: [召唤, 打开], // 以这些词开头时退出唤醒状态 exitKeywords: [退出, 关闭], }说小爱同学召唤傻妞进入状态之后直接提问即可说退出傻妞离开。注意并非所有型号都支持连续对话不稳定的机型把streamResponse设为false更稳妥。自定义角色bot.profile和master.profile两个人设字段决定了它怎么跟你说话。写毒舌但靠谱的技术顾问和写乖巧可爱的陪伴角色同一个模型会给出完全不同的语气。第三方 TTS 音色嫌小爱默认声音机械可以接火山引擎、ChatTTS 等第三方服务改.env里的TTS_BASE_URL和speaker.tts即可完整教程见 docs/tts.md。真实对话示例配置完成后实际用起来大致是这样的节奏你小爱同学请介绍一下量子计算机和普通计算机的区别 小爱简单说普通计算机按 0 和 1 一位一位算量子计算机用量子比特 可以同时处于多种状态……一句话总结它擅长的是试所有可能的问题。 你那它现在实用吗 小爱说实话大部分场景还不如你的笔记本。它真正有优势的是 材料模拟和密码学那几类问题离日常应用还有距离。 你小爱同学召唤傻妞 小爱进入唤醒状态你好我是傻妞很高兴认识你 你讲个程序员的笑话 小爱为什么程序员总分不清万圣节和圣诞节因为 Oct 31 等于 Dec 25。 小爱我说完了还有其他问题吗 你小爱同学退出傻妞连续对话模式下第二问那它现在实用吗不需要重复唤醒词上下文会被带进大模型。遇到问题怎么办按现象排查启动失败类现象提示70016登录验证失败 →处理小米 ID 填成了手机号或邮箱去账号个人信息页查真实的小米 ID现象提示触发异地登录保护 →处理在运行 MiGPT 的同一网络下登录小米官网手动通过安全验证等待约 1 小时海外服务器需先同意个人数据跨境传输协议现象提示找不到设备 →处理核对did与米家 APP 中的设备名逐字一致注意音响/音箱错别字和多余空格名称对不上时打开debug: true和enableTrace: true重启从日志的MiNA 设备列表里抄miotDID填进去AI 响应类现象控制台有回复但音箱不发声 →处理ttsCommand与你的型号不匹配按 docs/faq.md 中的截图教程去 miot-spec 查你型号的指令现象LLM 报 401 Invalid Authentication →处理检查OPENAI_API_KEY是否有效、环境变量是否真的加载进容器现象LLM 报 Connection error →处理国内网络直连 OpenAI 不通在.env里加HTTP_PROXYhttp://127.0.0.1:7890或改用国内大模型服务现象回答总是说到一半断掉 →处理配置该型号的playingCommand若该机型无法查询播放状态则把streamResponse设为false另外两点提醒配置文件里包含账号密码不要提交到任何公开仓库如果小爱正在放音乐先让它暂停再提问否则会收到不可预期的结果。更多参数的含义提示语、连续对话检测间隔、超时等见 docs/settings.md整体运行流程可以看 docs/how-it-works.md。MiGPT 的价值不在于多复杂而在于它把音箱→云端接口→大模型→语音播放这条链路封装成了一次配置。花二十分钟把.migpt.js和.env填对家里的音箱就从指令执行器变成了能接话的对话对象。后续如果音箱换型号或想换模型改的也只是这几个字段。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考