三步把小爱音箱接上大模型MiGPT 新手实操手册【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个把小爱音箱接入 ChatGPT、豆包等大模型的开源改造方案让它变成你的 AI 语音助手。你只需要一个小米账号、能运行 Docker 的设备和一个大模型 API Key读完本文就能独立完成 MiGPT 部署、模型配置和常见故障排查。第 1 节动手前回答你心里的三个问题值不值得折腾值得。改造后小爱同学从能放歌升级到能对话上知天文下知地理还能角色扮演、长短期记忆。说句实话项目官方已宣布停止更新但现有功能完整、文档齐全日常使用完全够用且不会突然失效。需要哪些前置条件对照下面这张自查表四项都打勾再动手前置条件✅ 已具备❌ 不满足时一台受支持的小爱音箱docs/compatibility.md 有型号清单Pro 推荐可开始部署项目仅支持小爱系列小度、天猫精灵等不支持小米账号以及纯数字的小米 ID继续下一步登录小米账号页查看「个人信息-小米 ID」不是手机号或邮箱能运行 Docker 的设备NAS、云服务器或闲置电脑继续下一步先装好 Docker或租一台入门云服务器即可一个 OpenAI 兼容接口的大模型 API Key继续下一步到模型服务商处申请国内可选手通义千问、DeepSeek 等全流程大概多久网络顺畅的话4 个部署步骤 30 分钟内能跑通加上模型调试和关键词配置预留 1 小时比较从容。中途卡住基本都出在第 4 节的故障表里。一句话记住先过四道前置条件再动手全程预计 1 小时内。第 2 节从零到跑起来MiGPT 部署四步走下面 4 步每步都给你成功信号和一个最常见的坑。步骤 1克隆项目代码把 MiGPT 源码拉到你的设备上git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt确认成功终端列出 README.md、Dockerfile、.env.example 等文件说明代码完整。 坑clone 中断或目录为空检查网络后重新执行没有 git 就先安装它。代码到手后先告诉 MiGPT大脑接在哪里。步骤 2配置大模型服务MiGPT 通过 OpenAI 兼容接口调用大模型.env文件就是填模型地址和钥匙的地方cp .env.example .env # 用文本编辑器打开 .env填好这三项变量名保持不变 OPENAI_MODELgpt-4o-mini # 改成你申请的模型名 OPENAI_API_KEYsk-xxxxxxxx # 改成你的密钥 OPENAI_BASE_URLhttps://api.openai.com/v1 # 非 OpenAI 服务改成对应地址确认成功.env里没有任何 xxx 占位符Key 与服务商后台一致。 坑国内直连 OpenAI 常失败建议直接换成国内模型只需改这三项的值详见 docs/faq.md。模型端就绪接下来告诉 MiGPT 要控制哪台音箱。步骤 3配置小爱音箱账号与设备.migpt.js里填小米账号和设备信息cp .migpt.example.js .migpt.js// 打开 .migpt.js修改 speaker 里的这几项 speaker: { userId: 987654321, // 小米 ID纯数字不是手机号 password: 你的密码, // 小米账号密码 did: 小爱音箱Pro, // 与米家 App 中设备名称完全一致 ttsCommand: [5, 1], // 按你的型号查对应指令 wakeUpCommand: [5, 3], }图按型号查到 ttsCommand 等参数后再填入配置确认成功文件保存无语法报错对错与否在第 4 步启动时验证。 坑did必须和米家中一字不差是音箱不是音响、无多余空格、注意大小写否则会报找不到设备。配置齐了一条命令启动服务。步骤 4启动服务并验证唤醒docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest确认成功docker ps里容器状态为 Up然后对音箱说小爱同学召唤傻妞它回答你好我是傻妞很高兴认识你即全链路打通。 坑Windows 终端不支持$(pwd)需手写绝对路径例如-v D:/hello/mi-gpt/.migpt.js:/app/.migpt.js。图启动成功后与小爱进行 AI 对话的效果现在基础功能已经跑起来了但要想用起来顺手还有三处场景化的调优。一句话记住克隆、改两个配置文件、docker run、唤醒说召唤傻妞。第 3 节让它真的好用小爱音箱模型与交互配置改动全部集中在.migpt.js的speaker区域改完重启 Docker 容器才生效。按三个真实场景讲。场景一出门前问天气一问一答说小爱同学请问明天天气这类以callAIKeywords里某个词开头的话AI 才会接管回答。把你常用的触发词加进去即可。场景二睡前听故事长回复更顺耳故事会被让我先想想我说完了这类提示语打断显得碎。把onAIAsking和onAIReplied设为空数组[]即可去掉提示语同时可以在bot.profile人设里加一句讲故事时语速慢、多用拟声词效果立刻不一样。场景三连续多轮对话进入唤醒模式后无需每句话都说小爱同学。开启streamResponse即可但注意只有 docs/compatibility.md 中标注支持的型号才适用其余型号请保持false否则回答会戛然而止。三处改动的汇总每行标了改哪里// .migpt.js → speaker 区域 callAIKeywords: [请, 你, 傻妞], // 场景一一问一答触发词 wakeUpKeywords: [打开, 进入, 召唤], // 场景二/三进入连续对话的词 streamResponse: true, // 场景三开启连续对话 exitKeepAliveAfter: 30, // 连续对话静默 30 秒自动退出一句话记住关键词决定它何时答、何时连答改完重启容器。第 4 节翻车急救高频故障速查现象最可能原因一条命令定位解法启动报70016登录验证失败填了手机号/邮箱而非纯数字小米 IDdocker logs 容器ID账号页查小米 ID改userId提示触发异地登录保护小米账号需安全验证同上看终端报错在与 MiGPT 相同网络下登录小米官网过验证等约 1 小时找不到设备xxxdid与米家不一致空格/大小写/错字米家 App 查设备名直接复制米家中的名称粘贴如小爱音箱Pro终端有 AI 回复音箱不发声该型号 TTS 指令不同无命令查型号表按型号查ttsCommand正确值后修改LLM 响应异常 Connection error网络无法访问模型服务docker logs 容器ID换国内模型或在.env填HTTP_PROXY图按型号查询对应的 TTS 播放指令图回答总被截断时按此查询播放状态指令 playingCommand表外问题的排查万能思路docker logs 容器ID看最新报错错误信息基本直接指向原因在.migpt.js打开debug: true重启容器输出更详细的日志再比对仍无解把完整错误信息拿去项目 FAQ 和 issue 里搜多数有人踩过docs/faq.md。一句话记住八成错误都在日志里先看日志再改配置。第 5 节进阶与拓展多设备、换模型、换音色多设备部署一台设备一个容器各自挂载独立的.migpt.js和.env家里每个房间都能配一台入口就是第 2 节那条docker run加不同的-v挂载。接入其他大模型任何兼容 OpenAI SDK 的服务通义千问、DeepSeek、Moonshot、本地 Ollama都能换只需改.env里OPENAI_BASE_URL和OPENAI_MODEL两个值。换 AI 音色可接入豆包同款等第三方 TTS 服务让回答声音更像真人配置见 docs/tts.md。一句话记住多设备就是复制容器换模型只改两行环境变量。结尾建议先完整跑通第 2 节确认链路畅通再回来按第 3 节的场景逐项调优。更多细节参见项目文档目录 docs/。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
三步把小爱音箱接上大模型MiGPT 新手实操手册【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个把小爱音箱接入 ChatGPT、豆包等大模型的开源改造方案让它变成你的 AI 语音助手。你只需要一个小米账号、能运行 Docker 的设备和一个大模型 API Key读完本文就能独立完成 MiGPT 部署、模型配置和常见故障排查。第 1 节动手前回答你心里的三个问题值不值得折腾值得。改造后小爱同学从能放歌升级到能对话上知天文下知地理还能角色扮演、长短期记忆。说句实话项目官方已宣布停止更新但现有功能完整、文档齐全日常使用完全够用且不会突然失效。需要哪些前置条件对照下面这张自查表四项都打勾再动手前置条件✅ 已具备❌ 不满足时一台受支持的小爱音箱docs/compatibility.md 有型号清单Pro 推荐可开始部署项目仅支持小爱系列小度、天猫精灵等不支持小米账号以及纯数字的小米 ID继续下一步登录小米账号页查看「个人信息-小米 ID」不是手机号或邮箱能运行 Docker 的设备NAS、云服务器或闲置电脑继续下一步先装好 Docker或租一台入门云服务器即可一个 OpenAI 兼容接口的大模型 API Key继续下一步到模型服务商处申请国内可选手通义千问、DeepSeek 等全流程大概多久网络顺畅的话4 个部署步骤 30 分钟内能跑通加上模型调试和关键词配置预留 1 小时比较从容。中途卡住基本都出在第 4 节的故障表里。一句话记住先过四道前置条件再动手全程预计 1 小时内。第 2 节从零到跑起来MiGPT 部署四步走下面 4 步每步都给你成功信号和一个最常见的坑。步骤 1克隆项目代码把 MiGPT 源码拉到你的设备上git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt确认成功终端列出 README.md、Dockerfile、.env.example 等文件说明代码完整。 坑clone 中断或目录为空检查网络后重新执行没有 git 就先安装它。代码到手后先告诉 MiGPT大脑接在哪里。步骤 2配置大模型服务MiGPT 通过 OpenAI 兼容接口调用大模型.env文件就是填模型地址和钥匙的地方cp .env.example .env # 用文本编辑器打开 .env填好这三项变量名保持不变 OPENAI_MODELgpt-4o-mini # 改成你申请的模型名 OPENAI_API_KEYsk-xxxxxxxx # 改成你的密钥 OPENAI_BASE_URLhttps://api.openai.com/v1 # 非 OpenAI 服务改成对应地址确认成功.env里没有任何 xxx 占位符Key 与服务商后台一致。 坑国内直连 OpenAI 常失败建议直接换成国内模型只需改这三项的值详见 docs/faq.md。模型端就绪接下来告诉 MiGPT 要控制哪台音箱。步骤 3配置小爱音箱账号与设备.migpt.js里填小米账号和设备信息cp .migpt.example.js .migpt.js// 打开 .migpt.js修改 speaker 里的这几项 speaker: { userId: 987654321, // 小米 ID纯数字不是手机号 password: 你的密码, // 小米账号密码 did: 小爱音箱Pro, // 与米家 App 中设备名称完全一致 ttsCommand: [5, 1], // 按你的型号查对应指令 wakeUpCommand: [5, 3], }图按型号查到 ttsCommand 等参数后再填入配置确认成功文件保存无语法报错对错与否在第 4 步启动时验证。 坑did必须和米家中一字不差是音箱不是音响、无多余空格、注意大小写否则会报找不到设备。配置齐了一条命令启动服务。步骤 4启动服务并验证唤醒docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest确认成功docker ps里容器状态为 Up然后对音箱说小爱同学召唤傻妞它回答你好我是傻妞很高兴认识你即全链路打通。 坑Windows 终端不支持$(pwd)需手写绝对路径例如-v D:/hello/mi-gpt/.migpt.js:/app/.migpt.js。图启动成功后与小爱进行 AI 对话的效果现在基础功能已经跑起来了但要想用起来顺手还有三处场景化的调优。一句话记住克隆、改两个配置文件、docker run、唤醒说召唤傻妞。第 3 节让它真的好用小爱音箱模型与交互配置改动全部集中在.migpt.js的speaker区域改完重启 Docker 容器才生效。按三个真实场景讲。场景一出门前问天气一问一答说小爱同学请问明天天气这类以callAIKeywords里某个词开头的话AI 才会接管回答。把你常用的触发词加进去即可。场景二睡前听故事长回复更顺耳故事会被让我先想想我说完了这类提示语打断显得碎。把onAIAsking和onAIReplied设为空数组[]即可去掉提示语同时可以在bot.profile人设里加一句讲故事时语速慢、多用拟声词效果立刻不一样。场景三连续多轮对话进入唤醒模式后无需每句话都说小爱同学。开启streamResponse即可但注意只有 docs/compatibility.md 中标注支持的型号才适用其余型号请保持false否则回答会戛然而止。三处改动的汇总每行标了改哪里// .migpt.js → speaker 区域 callAIKeywords: [请, 你, 傻妞], // 场景一一问一答触发词 wakeUpKeywords: [打开, 进入, 召唤], // 场景二/三进入连续对话的词 streamResponse: true, // 场景三开启连续对话 exitKeepAliveAfter: 30, // 连续对话静默 30 秒自动退出一句话记住关键词决定它何时答、何时连答改完重启容器。第 4 节翻车急救高频故障速查现象最可能原因一条命令定位解法启动报70016登录验证失败填了手机号/邮箱而非纯数字小米 IDdocker logs 容器ID账号页查小米 ID改userId提示触发异地登录保护小米账号需安全验证同上看终端报错在与 MiGPT 相同网络下登录小米官网过验证等约 1 小时找不到设备xxxdid与米家不一致空格/大小写/错字米家 App 查设备名直接复制米家中的名称粘贴如小爱音箱Pro终端有 AI 回复音箱不发声该型号 TTS 指令不同无命令查型号表按型号查ttsCommand正确值后修改LLM 响应异常 Connection error网络无法访问模型服务docker logs 容器ID换国内模型或在.env填HTTP_PROXY图按型号查询对应的 TTS 播放指令图回答总被截断时按此查询播放状态指令 playingCommand表外问题的排查万能思路docker logs 容器ID看最新报错错误信息基本直接指向原因在.migpt.js打开debug: true重启容器输出更详细的日志再比对仍无解把完整错误信息拿去项目 FAQ 和 issue 里搜多数有人踩过docs/faq.md。一句话记住八成错误都在日志里先看日志再改配置。第 5 节进阶与拓展多设备、换模型、换音色多设备部署一台设备一个容器各自挂载独立的.migpt.js和.env家里每个房间都能配一台入口就是第 2 节那条docker run加不同的-v挂载。接入其他大模型任何兼容 OpenAI SDK 的服务通义千问、DeepSeek、Moonshot、本地 Ollama都能换只需改.env里OPENAI_BASE_URL和OPENAI_MODEL两个值。换 AI 音色可接入豆包同款等第三方 TTS 服务让回答声音更像真人配置见 docs/tts.md。一句话记住多设备就是复制容器换模型只改两行环境变量。结尾建议先完整跑通第 2 节确认链路畅通再回来按第 3 节的场景逐项调优。更多细节参见项目文档目录 docs/。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
