小爱音箱如何接入 ChatGPT 和豆包?MiGPT 三步部署与定制完全指南

发布时间:2026/9/14 17:12:49
小爱音箱如何接入 ChatGPT 和豆包?MiGPT 三步部署与定制完全指南 小爱音箱如何接入 ChatGPT 和豆包MiGPT 三步部署与定制完全指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个把小爱音箱接入 ChatGPT、豆包等大语言模型的开源项目配置好之后原本只会按固定题库作答的语音设备会变成能聊天、答疑、还能调教性格的 AI 语音助手。下面按先确认硬件、再一键部署、最后深度定制的顺序带你把家里的音箱真正用起来全程不需要写代码。一、先确认你的音箱能不能接动手之前先回答一个问题家里得有一台小爱音箱。MiGPT 只适配小爱系设备小度、天猫精灵、HomePod 等均不在支持范围内也没有适配计划。小爱家族里小爱音箱 Pro 表现最稳多数其他型号也能正常跑只是连续对话等进阶功能可能受限。项目自带一份型号兼容表每台机器需要的指令参数都列在里面配置前务必查一下自己那一行docs/compatibility.md图里演示的是小爱音箱 Pro型号 LX06查参数的过程在小米官方的 MIoT 规格查询站点搜型号进规格文档就能看到音箱支持的动作列表。你之后要填的ttsCommand、wakeUpCommand本质上就是其中播放文字唤醒两个动作对应的编号抄下来即可。型号一般印在音箱底部标签上也可以在米家 App 的设备详情页找到。另外注意部分型号无法正确查询播放状态这类机器要关闭连续对话streamResponse设为false兼容表里逐台标注了。二、部署 MiGPT两种方式任选其一方式一Docker 一行命令新手首选家里如果有 NAS、树莓派或闲置电脑装了 Docker这是最省事的路。先按下一节准备好.env和.migpt.js两个配置文件然后执行docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest在 Windows 终端下把$(pwd)换成配置文件的绝对路径即可。方式二Node.js 从源码启动开发者可以直接拉代码运行要求 Node.js 16.0git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt npm install npm run dev如果想把它当库集成进自己的项目npm install mi-gpt后用MiGPT.create初始化就行入口在 src/index.ts本地开发流程见 docs/development.md。两个配置文件各填各的.env决定接哪个大脑只需填模型相关的几项OPENAI_API_KEY你的 API 密钥 OPENAI_MODELgpt-4o OPENAI_BASE_URL你的模型 API 网关地址 # 可选.migpt.js决定连哪台音箱、以谁的身份对话module.exports { speaker: { userId: 你的小米 ID, // 注意是小米 ID不是手机号或邮箱 password: 账号密码, did: 小爱音箱 Pro, // 米家中设置的名称或设备 ID ttsCommand: [5, 1], wakeUpCommand: [5, 3] } };这两个指令编号长什么样、从哪查见下图以音箱 SIID 5 下的play-text和wake-up动作为例具体到每台机器编号不同以兼容表为准每个字段的完整含义在 docs/settings.md 都有说明。三、启动之后三种方式喊出你的 AI 助手控制台出现类似下面的日志就说明部署成功了2024/05/21 21:51:44 Speaker ✅ 服务已启动... 2024/05/21 21:51:52 Speaker 你好我是豆包很高兴为你服务之后对着音箱正常说话就行有三种常用句式小爱同学请 xxx——比如小爱同学为什么地球是圆的小爱同学你 xxx——比如小爱同学你喜欢我吗小爱同学召唤 xxx——进入唤醒模式后续几轮对话不用每句都喊小爱同学唤醒状态下可以连续追问30 秒没动静会自动退出可用exitKeepAliveAfter调节。这些触发词全部可自定义callAIKeywords、wakeUpKeywords、exitKeywords连进入和退出时的欢迎语、提示语onEnterAI、onExitAI等都能改成自己的话术。四、三项定制让它真正长在你家换大脑ChatGPT、豆包、千问两行配置切换MiGPT 兼容所有走 OpenAI 接口的模型。想用豆包、通义千问、Kimi、DeepSeek只改.env里的OPENAI_BASE_URL、OPENAI_MODEL、OPENAI_API_KEY三个值。若目标模型本身不提供 OpenAI 格式接口可以加一层 API 聚合网关转换后再接具体思路参考 docs/faq.md。调性格给它写一份人设.migpt.js里可以给机器人bot和你master分别起名、写人设还可以给这段对话起个房间名roomAI 会完全按人设来扮演。更细的控制交给systemTemplate系统提示词模板——回答风格、篇幅、是否携带上下文都能调配套教程在 docs/prompt.md。换嗓音接入第三方 TTS默认用小米自带 TTS 朗读。想换音色把speaker.tts设为custom在.env里填TTS_BASE_URL指向你的 TTS 服务之后说一句小爱同学把声音换成 xxx就能随时切音色触发词由switchSpeakerKeywords决定。完整接入步骤见 docs/tts.md。五、越用越懂你长短期记忆MiGPT 的 AI 不是金鱼。它内置两级记忆短期记忆保存当前会话上下文让连续追问成立长期记忆后台由一个记忆管理专家从对话里提炼关键信息——你的偏好、重要日期、计划等——写入长期记忆库总字数控制在 1000 以内过时的内容会被自动淡化。用上一段时间再聊明显比第一天上手更对味。相关实现可以翻 src/services/bot/memory/。六、排坑手册出问题先查这几处音箱连不上九成出在三件套——userId强调一次是小米 ID不是手机号或邮箱、password、did米家 App 里的设备名或设备 ID。AI 不回话先确认密钥有效、网关地址和模型名拼写正确再看控制台报错。如果模型本身慢可以换个响应更快的模型或把回答前后的提示语关掉onAIAsking、onAIReplied置为空数组。声音或播放异常对照兼容表核对本机ttsCommand检查音箱音量重启服务。若该型号播放状态查询不可靠关闭streamResponse个别情况才需要配置playingCommand它对应规格文档里 Play ControlSIID 3下的playing-state属性如下图顺带一提项目 README 顶部注明已停止维护、不再提供更新。现有功能仍可稳定使用但后续遇到新硬件或新玩法时请自行留意版本状态。七、想深入时去哪查配置参数全解docs/settings.md型号兼容与指令参数docs/compatibility.mdMiGPT 工作原理docs/how-it-works.md常见问题docs/faq.md核心源码src/services/音箱控制、记忆、会话逻辑都在这说到底MiGPT 做的事不复杂用一段桥接程序让音箱的开放接口和大模型 API 握手再让音箱把模型的回复读出来。模型、人设、嗓音、唤醒词……每一样都留给你自己定义。把音箱接上线先喊它一句试试。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考