三步接入小爱音箱大模型MiGPT 免费 AI 语音助手部署完整指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个开源项目能把小爱音箱接入 ChatGPT 等大模型让它从人工智障变成会连续对话的 AI 语音助手。这篇指南带你先查设备兼容性再用 Docker 三步完成 MiGPT 部署最后讲模型配置、唤醒模式、70016 错误排查和提速技巧每一步都可以直接照着做。一、先确认型号哪些小爱音箱能跑 MiGPT为什么同样的 MiGPT有的音箱体验流畅有的却只能半残差别在硬件对 MIoT 接口的支持程度。官方把已验证的机型分成三档档位代表型号连续对话streamResponse说明✅ 完美运行小爱音箱 ProLX06、Xiaomi 智能音箱 ProOH2P、小爱音箱 Play 2019 款LX05支持官方推荐小爱音箱 Pro⚠️ 正常运行小爱音箱L06A、小爱音箱 miniLX01、小爱音箱 PlayL05B、小爱触屏音箱LX04等不支持能问答但要关掉streamResponse部分机型播放状态查询异常会导致句子戛然而止❌ 不支持小米小爱音箱 HDSM4、小米小爱蓝牙音箱随身版不支持完全无法运行另外明确一下小度音箱、天猫精灵、HomePod 均不支持也没有适配计划。每个型号的 TTS 指令、唤醒指令、播放状态查询指令都不同需要在 docs/compatibility.md 中按型号查好ttsCommand、wakeUpCommand、playingCommand填进配置。如果你的音箱收到了回复但没出声或话说一半就停九成是这两个指令没配对可以去 MIoT 开放平台的设备规格页查自己型号的指令二、Docker 三步启动 MiGPT不想折腾 Node 环境的话Docker 是官方推荐的方式。先确认这一步你的机器上已经装好 Docker并且准备好了两个配置文件docs/settings.md 有完整参数说明。克隆项目代码到本地# 拿到源码配置文件模板就在根目录里 git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt准备两个配置文件把.env.example改名为.env填大模型接入信息把.migpt.example.js改名为.migpt.js填小米账号和设备信息// .migpt.js export default { speaker: { // 小米 ID注意不是手机号或邮箱在账号个人信息页查看 userId: 987654321, password: 你的小米账号密码, // 设备名必须和米家中完全一致无多余空格、注意大小写填不对会提示找不到设备 did: 小爱音箱Pro, }, };启动容器官方镜像已支持 amd64 / arm64 / arm32 三种架构# 挂载 .env 和 .migpt.js 两个文件容器内路径固定为 /app docker run -d --env-file $(pwd)/.env \ -v $(pwd)/.migpt.js:/app/.migpt.js \ idootop/mi-gpt:latestWindows 终端PowerShell、cmd里$(pwd)取不到当前目录必须把两个路径都写成绝对路径例如D:/hello/mi-gpt/.env否则启动后会报ERR_MODULE_NOT_FOUND。如果你有改代码的需求也可以自己构建镜像docker build -t mi-gpt .然后用docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js mi-gpt启动自建的镜像细节见 docs/development.md。启动成功后对音箱说小爱同学请问地球为什么是圆的能听到 AI 回答就说明部署完成了。三、大模型怎么选云端、本地还是混搭MiGPT 走的是 OpenAI 兼容协议理论上任何提供 OpenAI 格式 API 的模型都能接改 src/services/openai.ts 对应的环境变量就行# .env三个变量决定请求发往哪里、用哪个模型、拿什么凭证 OPENAI_BASE_URLhttps://api.openai.com/v1 OPENAI_MODELgpt-4o OPENAI_API_KEY你的密钥 HTTP_PROXYhttp://127.0.0.1:7890 # 国内直连 OpenAI 需要代理用国内模型可留空想省 token 或保护隐私可以在本地用 Ollama、LM Studio 起一个模型服务——它们自带 OpenAI 兼容接口把OPENAI_BASE_URL指过去、OPENAI_MODEL换成你的本地模型名即可。想接通义千问、DeepSeek、Moonshot 这类国内云端模型同样只改这三个变量。这里要说明一个常见误解MiGPT 本身没有内置按问题复杂度自动路由到本地或云端的开关。所谓本地 云端混合实际是靠换端点实现的——日常用本地端点需要更强能力时把OPENAI_BASE_URL切回云端或用 API 聚合网关统一收口。网络出问题时降级顺序是先换代理节点403 通常是代理 IP 被风控再把HTTP_PROXY设成空字符串改走国内模型。四、两种唤醒模式怎么选每次唤醒还是连续对话小爱音箱的小爱同学唤醒词写死在固件里外部改不了但唤醒之后哪句话触发 AI是可以在.migpt.js里自定义的。两种模式差异如下普通唤醒唤醒模式连续对话怎么触发小爱同学请 xxx小爱同学召唤傻妞能否连问不行每句都要先喊小爱同学可以进入后直接提问对应配置callAIKeywordswakeUpKeywordsexitKeywords硬性前提无机型支持连续对话streamResponse: truemini、Play 等老款不行// .migpt.js export default { speaker: { // 以这些词开头的消息会调用 AI 回复按自家习惯改 callAIKeywords: [请, 你, 傻妞], // 以这些词开头进入连续对话模式类似一个常驻技能 wakeUpKeywords: [召唤傻妞, 打开傻妞], // 说退出傻妞之类的话可以主动结束 exitKeywords: [退出傻妞, 关闭傻妞], // 连续对话中超过 30 秒没提问会自动退出防误唤醒 exitKeepAliveAfter: 30, }, };使用上有两个容易踩的坑一是等小爱说完我说完了之后再提问它回答或没在听的时候说的话是收不到的二是唤醒词如果恰好像歌名比如唤醒小爱可能会去播歌换一个词就好。五、70016 错误三步排查法启动时提示70016登录验证失败是新手遇到的头号问题。它只表示小米账号登录没通过背后按出现概率排序有三类原因建议按这个顺序查开始 → 打开 .migpt.js 检查 userId ├─ 不是纯数字小米 ID → 换成账号个人信息页的小米 ID手机号/邮箱都不行重启 └─ 是 → 检查密码是否正确 ├─ 错 → 更新密码重启 └─ 对 → 是否触发了异地登录保护 ├─ 是 → 在与容器相同的网络环境下用小米官网登录账号手动 │ 通过安全验证等待约 1 小时再试海外服务器还需先 │ 同意个人数据跨境传输协议 └─ 还不行 → 终极方案先在本地网络跑一次 MiGPT 登录成功 导出 .mi.json挂载到容器里复用复用凭证的启动命令长这样# 多挂载一个 .mi.json容器启动后直接跳过登录验证 docker run -d --env-file $(pwd)/.env \ -v $(pwd)/.migpt.js:/app/.migpt.js \ -v $(pwd)/.mi.json:/app/.mi.json \ idootop/mi-gpt:latest另外两种启动报错顺带提一下提示找不到设备xxx十有八九是did和米家中的设备名不一致音响vs音箱、多一个空格实在对不上可以开debug: true和enableTrace: true从日志的MiNA 设备列表里找到miotDID直接填数字 ID。共享给别人的音箱用 MiNA 接口取不到会启动失败。六、 让回复更快的参数调优默认配置偏保守。想让回答更快、停顿更少优先动 docs/faq.md 里提到的这几个参数// .migpt.js export default { speaker: { // 空数组表示去掉让我先想想我说完了等提示语省下两句播报的时间 onAIAsking: [], onAIReplied: [], // 连续对话时检测播放状态的间隔默认 1 秒最低 500 毫秒。 // 调小能缩短两轮回答之间的停顿感但对老旧机型太激进反而不稳 checkInterval: 500, // 下发 TTS 指令后等多久再查播放状态默认 3 秒不建议低于 1 秒 checkTTSStatusAfter: 3, }, };其他有效手段换成响应快的模型如gpt-3.5-turbo确认流式响应开着——MiGPT 会把大模型回答按句切成小段依次播报单句上限默认 100 字、首段聚合 200 毫秒实现在 src/services/speaker/stream.ts首句等待远小于整段播完。也要有心理预期从你开口到小爱抢话被静音中间有 1-2 秒云端轮询延迟这是接口方案的固有限制无法彻底消除。嫌它话多直接说小爱同学请你闭嘴打断即可。七、想更进一步社区扩展与贡献路径不想改代码但想玩出花样社区已经有很多现成方向图形化管理多账号的 MiGPT GUI、基于 Vue 的可视化配置中心、支持摄像头识别的分支让小爱看到现实世界。想接豆包同款音色火山 TTS可以看 docs/tts.md想多账号多设备直接多起几个不同配置的容器。想改代码按 docs/development.md 走本地开发流程即可git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install # 默认 Node 20版本过低可能启动失败 pnpm build # 生成 Prisma client 并打包 pnpm dev # 配置好 .env 和 .migpt.js 后直接启动参与贡献的建议路径先在 issue 列表搜一下有没有同类问题 → 本地跑通并复现 → 修改后用 VS Code 的 F5 调试确认 → 提交 issue 或 PR。遇到新坑记得带上错误日志反馈这也是社区迭代的主要来源。总结回到起点回顾一下先按 docs/compatibility.md 确认机型再走Docker 三步把 MiGPT 跑起来然后按需求在云端和本地模型间切换端点选一种唤醒模式卡住了就按 70016 三步排查法走一遍。整套流程走通大概不到半小时你的小爱音箱就能接上大模型了。现在动手试试吧——部署中遇到的任何报错欢迎到项目仓库提交 issue 反馈附上日志会大大加快定位速度。项目仓库mi-gptgit clone https://gitcode.com/GitHub_Trending/mi/mi-gpt官方文档docs/涵盖参数设置、常见问题、工作原理与 TTS 接入【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考