如何把小爱音箱接入大语言模型MiGPT 完整配置与实践指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt对音箱说「小爱同学天空为什么是蓝色」得到的不再是固定话术而是一段语义完整的解答这正是 MiGPT 做的事用两个配置文件把小爱音箱接入 ChatGPT 等大语言模型让设备变成能回答开放性问题的语音助手。配置项很少第一次接触也能照做跑通。能力与边界MiGPT 接管音箱的语音应答链路大模型问答、流式语音回复、角色人设与 TTS 音色、长短期记忆均默认可用。两个边界需要明确它仅支持小米小爱音箱其他品牌音箱不在适配计划内连续对话依赖音箱可查询播放状态部分型号需将streamResponse关闭。另外项目已停止更新新固件与新型号建议以当前代码为准。动手前的准备 以下六项在动手前逐项确认前置项要求获取方式音箱设备小米小爱音箱推荐小爱音箱 Pro 等完美兼容型号查看 docs/compatibility.md 型号兼容表小米账号小米 ID 密码注意不是手机号或邮箱账号中心「个人信息」页查看「小米 ID」音箱名称米家 App 中设置的名称大小写与空格需完全一致米家 App → 音箱页 → 设备名称也可使用设备 did运行环境Node.js 16 及以上或 Dockernode -v查看版本Docker 按官方说明安装大模型密钥OpenAI 兼容接口密钥、模型名、服务地址在所用大模型服务商处申请获取MIoT 指令ttsCommand与wakeUpCommand两组指令在 MIoT 平台设备规格页搜索音箱型号查询最小可运行配置先获取代码并复制两个示例文件git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install cp .env.example .env cp .migpt.example.js .migpt.js修改 .env 的三项大模型接入配置字段含义常见填错点OPENAI_API_KEY大模型服务密钥需与申请的服务商对应不同商前缀不同OPENAI_MODEL模型名称如gpt-4o-mini须与密钥匹配OPENAI_BASE_URL服务接口地址一般以/v1结尾非 OpenAI 模型填服务商地址勿漏/v1接入国产或其他模型时环境变量名不变只把这三个值指向对应服务详细说明见 docs/faq.md。修改 .migpt.js 的四项音箱连接配置speaker: { userId: 987654321, // 小米 ID不是手机号或邮箱 password: 123456, // 小米账号密码 did: 小爱音箱Pro, // 米家中名称注意大小写与空格 ttsCommand: [5, 1], // 语音合成指令因型号而异 wakeUpCommand: [5, 3] // 唤醒音箱指令因型号而异 }userId是最常填错的一项只填数字型小米 IDdid建议直接从米家复制避免「小爱音响」这类错别字。ttsCommand与wakeUpCommand每个音箱型号不同小爱音箱 Pro 为[5,1]与[5,3]其他型号到 MIoT 规格页查询SIID 与 AIID 组合成指令。两个文件保存后音箱即可开始应答后续个性化都在这份最小配置上调整。个性化定制三类定制都只改.migpt.js与.env两个文件修改后重启服务生效。MiGPT 人设定制改 .migpt.js 的 bot 与 master改bot下的name与profile决定音箱的称呼、性格与爱好改master下同名项填写使用者信息。四个字段会注入系统提示词模板systemTemplate回复长度与风格规则在模板里调整写法参考 docs/prompt.md。MiGPT 唤醒词与退出词自定义改 .migpt.js 的 speaker 关键词字段作用wakeUpKeywords进入 AI 模式的词默认[打开, 进入, 召唤]exitKeywords退出 AI 模式的词默认[关闭, 退出, 再见]callAIKeywords单次调用词消息以这些词开头即转大模型onEnterAI/onExitAI进入与退出的提示语设空数组可关闭MiGPT TTS 换声接入第三方音色默认使用小爱自带 TTS。换第三方音色时在.env填TTS_BASE_URL并在.migpt.js将tts设为custom想用语音指令切换音色再配置switchSpeakerKeywords。接口规范与本地部署示例见 docs/tts.md。启动与验证Node.js 环境直接启动pnpm startDocker 部署用一条命令替代docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest启动成功后控制台输出Speaker ✅ 服务已启动...随后做三个验证动作「小爱同学请问天空为什么是蓝色」音箱朗读大模型答案控制台打印 AI 应答内容。「小爱同学召唤傻妞」进入连续对话模式并朗读onEnterAI欢迎语之后提问无需再带唤醒词。「小爱同学再见」退出 AI 模式并朗读onExitAI提示语。排障速查现象可能原因处理方式启动提示「70016登录验证失败」userId填了手机号或邮箱或密码错误改用账号中心「个人信息」中的「小米 ID」提示触发异地登录保护小米账号风控在相同网络下手动登录小米账号完成验证约 1 小时后重试提示「找不到设备xxx」did与米家名称不一致从米家复制设备名称仍失败则开enableTrace取miotDID填入语音提问无反应音箱正在放歌或上条回复未结束就提问先说「暂停」或等提示语结束后再提问AI 响应慢模型响应慢或提示语拉长等待换更快的模型将onAIAsking、onAIReplied设为空数组连续对话频繁中断该型号播放状态查询不准streamResponse设为false改回「小爱同学请 xxx」单次问答可选进阶 每条均为可选项按需启用长短期记忆短期记忆保存会话上下文长期记忆沉淀偏好实现在 src/services/bot/memory/默认启用。代理接入运行环境无法直连大模型服务时参考 src/services/proxy.ts 配置代理环境变量。智能家居联动实验性尚在 docs/roadmap.md 规划中当前版本未开放。总结与资源清单全部必要配置只有.env与.migpt.js两个文件保存后音箱即可通过大模型应答提问。配置参数文档常见问题排查音箱型号兼容表提示词编写指南第三方 TTS 接入工作原理说明官方教程PDF源码目录【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何把小爱音箱接入大语言模型MiGPT 完整配置与实践指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt对音箱说「小爱同学天空为什么是蓝色」得到的不再是固定话术而是一段语义完整的解答这正是 MiGPT 做的事用两个配置文件把小爱音箱接入 ChatGPT 等大语言模型让设备变成能回答开放性问题的语音助手。配置项很少第一次接触也能照做跑通。能力与边界MiGPT 接管音箱的语音应答链路大模型问答、流式语音回复、角色人设与 TTS 音色、长短期记忆均默认可用。两个边界需要明确它仅支持小米小爱音箱其他品牌音箱不在适配计划内连续对话依赖音箱可查询播放状态部分型号需将streamResponse关闭。另外项目已停止更新新固件与新型号建议以当前代码为准。动手前的准备 以下六项在动手前逐项确认前置项要求获取方式音箱设备小米小爱音箱推荐小爱音箱 Pro 等完美兼容型号查看 docs/compatibility.md 型号兼容表小米账号小米 ID 密码注意不是手机号或邮箱账号中心「个人信息」页查看「小米 ID」音箱名称米家 App 中设置的名称大小写与空格需完全一致米家 App → 音箱页 → 设备名称也可使用设备 did运行环境Node.js 16 及以上或 Dockernode -v查看版本Docker 按官方说明安装大模型密钥OpenAI 兼容接口密钥、模型名、服务地址在所用大模型服务商处申请获取MIoT 指令ttsCommand与wakeUpCommand两组指令在 MIoT 平台设备规格页搜索音箱型号查询最小可运行配置先获取代码并复制两个示例文件git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install cp .env.example .env cp .migpt.example.js .migpt.js修改 .env 的三项大模型接入配置字段含义常见填错点OPENAI_API_KEY大模型服务密钥需与申请的服务商对应不同商前缀不同OPENAI_MODEL模型名称如gpt-4o-mini须与密钥匹配OPENAI_BASE_URL服务接口地址一般以/v1结尾非 OpenAI 模型填服务商地址勿漏/v1接入国产或其他模型时环境变量名不变只把这三个值指向对应服务详细说明见 docs/faq.md。修改 .migpt.js 的四项音箱连接配置speaker: { userId: 987654321, // 小米 ID不是手机号或邮箱 password: 123456, // 小米账号密码 did: 小爱音箱Pro, // 米家中名称注意大小写与空格 ttsCommand: [5, 1], // 语音合成指令因型号而异 wakeUpCommand: [5, 3] // 唤醒音箱指令因型号而异 }userId是最常填错的一项只填数字型小米 IDdid建议直接从米家复制避免「小爱音响」这类错别字。ttsCommand与wakeUpCommand每个音箱型号不同小爱音箱 Pro 为[5,1]与[5,3]其他型号到 MIoT 规格页查询SIID 与 AIID 组合成指令。两个文件保存后音箱即可开始应答后续个性化都在这份最小配置上调整。个性化定制三类定制都只改.migpt.js与.env两个文件修改后重启服务生效。MiGPT 人设定制改 .migpt.js 的 bot 与 master改bot下的name与profile决定音箱的称呼、性格与爱好改master下同名项填写使用者信息。四个字段会注入系统提示词模板systemTemplate回复长度与风格规则在模板里调整写法参考 docs/prompt.md。MiGPT 唤醒词与退出词自定义改 .migpt.js 的 speaker 关键词字段作用wakeUpKeywords进入 AI 模式的词默认[打开, 进入, 召唤]exitKeywords退出 AI 模式的词默认[关闭, 退出, 再见]callAIKeywords单次调用词消息以这些词开头即转大模型onEnterAI/onExitAI进入与退出的提示语设空数组可关闭MiGPT TTS 换声接入第三方音色默认使用小爱自带 TTS。换第三方音色时在.env填TTS_BASE_URL并在.migpt.js将tts设为custom想用语音指令切换音色再配置switchSpeakerKeywords。接口规范与本地部署示例见 docs/tts.md。启动与验证Node.js 环境直接启动pnpm startDocker 部署用一条命令替代docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest启动成功后控制台输出Speaker ✅ 服务已启动...随后做三个验证动作「小爱同学请问天空为什么是蓝色」音箱朗读大模型答案控制台打印 AI 应答内容。「小爱同学召唤傻妞」进入连续对话模式并朗读onEnterAI欢迎语之后提问无需再带唤醒词。「小爱同学再见」退出 AI 模式并朗读onExitAI提示语。排障速查现象可能原因处理方式启动提示「70016登录验证失败」userId填了手机号或邮箱或密码错误改用账号中心「个人信息」中的「小米 ID」提示触发异地登录保护小米账号风控在相同网络下手动登录小米账号完成验证约 1 小时后重试提示「找不到设备xxx」did与米家名称不一致从米家复制设备名称仍失败则开enableTrace取miotDID填入语音提问无反应音箱正在放歌或上条回复未结束就提问先说「暂停」或等提示语结束后再提问AI 响应慢模型响应慢或提示语拉长等待换更快的模型将onAIAsking、onAIReplied设为空数组连续对话频繁中断该型号播放状态查询不准streamResponse设为false改回「小爱同学请 xxx」单次问答可选进阶 每条均为可选项按需启用长短期记忆短期记忆保存会话上下文长期记忆沉淀偏好实现在 src/services/bot/memory/默认启用。代理接入运行环境无法直连大模型服务时参考 src/services/proxy.ts 配置代理环境变量。智能家居联动实验性尚在 docs/roadmap.md 规划中当前版本未开放。总结与资源清单全部必要配置只有.env与.migpt.js两个文件保存后音箱即可通过大模型应答提问。配置参数文档常见问题排查音箱型号兼容表提示词编写指南第三方 TTS 接入工作原理说明官方教程PDF源码目录【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
