小爱音箱AI升级指南把音箱接入大模型1 小时拥有自己的AI语音助手【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个开源项目能把家里的小爱音箱接入 ChatGPT、豆包等大模型完成小爱音箱AI升级让它从只回固定话术变成随问随答的语音助手。本文带你走 Docker 部署、两个配置文件的修改和常见故障排查命令很少零基础也能照做。✨ 升级后小爱音箱能做什么大模型问答天文地理都能接告别敷衍回答角色扮演给它起名、写人设性格随你调教连续对话进入 AI 模式后免唤醒词连续聊长短期记忆记住聊过的细节越聊越懂你自定义音色接入第三方 TTS换掉原生嗓音 部署前准备清单资源最低要求获取途径小爱音箱兼容型号推荐小爱音箱 Pro已购设备即可电脑或服务器4GB 内存以上能常开家里的旧电脑也行运行环境Docker或 Node.js 20各大发行版包管理器小米账号音箱已绑定该账号米家 App大模型 API Key有可用额度各大模型平台注册装好 Docker 后先打开米家 App 进音箱详情页记下两样东西型号如 LX06和设备名称并对照 docs/compatibility.md 确认你的型号属于完美运行还是正常运行档。型号决定了后面要填的设备指令。 Docker 一键部署推荐路径整个部署只有四步装环境、拉代码、改配置、启动验证。第 1 步安装 Dockersudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io -y验证执行docker --version能输出版本号即成功。第 2 步克隆项目代码git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt验证在这个目录下能看到.migpt.example.js和.env.example两个示例文件。第 3 步复制并修改配置cp .migpt.example.js .migpt.js cp .env.example .env验证用编辑器打开这两个新文件能正常读写。具体改什么看下一节先不用急着填。第 4 步启动服务并验证docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest验证docker logs看到服务已启动字样后对小爱音箱说小爱同学请介绍一下你自己能正常发声回答即部署完成。注意 Windows 终端下$(pwd)不可用要换成配置文件的绝对路径。 两个配置文件讲透.migpt.js 与 .env整个项目只需维护这两个文件。.migpt.js管小米账号和音箱.env管大模型。.migpt.js账号、音箱与交互规则必填参数如下参数含义注意userId小米 ID是数字 ID不是手机号或邮箱password小米账号密码与绑定音箱的账号一致did音箱 ID 或米家设备名称空格、大小写、错别字都会导致找不到设备ttsCommandTTS 播放指令小爱音箱 ProLX06为[5, 1]wakeUpCommand唤醒指令小爱音箱 ProLX06为[5, 3]callAIKeywords以这些词开头时调用 AI 回答默认含请你等wakeUpKeywords进入 AI 唤醒模式的词如打开召唤exitKeywords退出 AI 模式的词如关闭退出代码里只需动这一段其余保持默认speaker: { userId: 你的小米ID, // 在小米账号中心「个人信息-小米ID」查看 password: 你的小米账号密码, did: 小爱音箱Pro, // 从米家App原样复制设备名称 ttsCommand: [5, 1], // 按你的型号查询填写 wakeUpCommand: [5, 3] }ttsCommand和wakeUpCommand不是猜的不同型号的指令不同按型号去 MIoT 规格查询站搜设备规格找到对应的 SIID 和 AIID 组合即可。.env接入大模型参数含义注意OPENAI_API_KEY模型服务的 API 密钥无效会报 401OPENAI_MODEL使用的模型名如gpt-4o-mini、qwen-turboOPENAI_BASE_URL模型服务接口地址一般以/v1结尾可选接入通义千问时改完这三行就能用OPENAI_MODELqwen-turbo OPENAI_API_KEY你的API密钥 OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1变量名不用改只换值即可。豆包等不兼容 OpenAI 接口的模型可以先用 One API 这类聚合工具转成 OpenAI 格式再把地址填进OPENAI_BASE_URL。 调优与场景定制让回答更快确认tts: xiaoai使用音箱自带 TTS把onAIAsking、onAIReplied设为空数组去掉首尾提示语连续对话场景把checkInterval调到 500 毫秒回复之间的停顿感会明显减少。开启连续对话streamResponse: true后进入 AI 模式就能免唤醒连聊exitKeepAliveAfter控制多久没人说话自动退出默认 30 秒。部分型号查不到播放状态这类机器要关掉该选项兼容列表里每个型号都标了是否支持。换个音色小爱原生嗓音听腻了可以部署第三方 TTS 服务如豆包同款的火山引擎音色.env里填TTS_BASE_URL.migpt.js里把tts改为custom之后说把声音换成 xxx即可切换音色详见 docs/tts.md。调教角色人设bot.name、bot.profile、master.name决定了 AI 以什么身份跟你说话systemTemplate控制行为规则。运行中也可以直接语音改人设比如小爱同学你是xxx你xxx。几个常见用法给孩子当学习问答伙伴睡前定时讲故事的闲聊陪伴出门前问今天天气和日程的晨间播报。同一套配置换人设就能换场景。 故障速查现象常见原因解决办法启动报70016登录验证失败userId填成了手机号或邮箱去小米账号中心查小米 ID数字串填入启动报找不到设备did与米家设备名称不一致错别字、空格、大小写从米家 App 原样复制名称仍失败就打开debug查设备的miotDID说了小爱同学请xxx却没有 AI 回答没有先唤醒或开头词不在callAIKeywords里先唤醒小爱再提问确认请等词在关键词列表中控制台有回复音箱却不发声该型号的ttsCommand填错按型号查 MIoT 规格站替换成正确指令回答说到一半戛然而止型号无法查询播放状态按规格站填playingCommand无效则关闭streamResponse 动手改造你的音箱一台吃灰的小爱音箱加一段下午时间就能换回一个随问随答的家庭 AI 语音助手改坏了大不了删掉容器重来。建议从 docs/settings.md 过一遍完整参数遇到问题先翻 docs/faq.md想换音色再看 docs/tts.md。现在就启动你的第一次小爱同学请介绍你自己吧。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考