3步把小爱音箱接入 ChatGPTMiGPT 新手实操指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt晚上你问小爱音箱帮我写一首关于月亮的诗它只会回你一句这个我还不会呢。问天气可以查快递可以但凡要它动动脑子它就原形毕露。这个尴尬有个解法用开源项目 MiGPT把小爱音箱接入 ChatGPT 这类大模型让它从人工智障变成能写诗、能聊天的语音助手。整个过程不需要刷机、不需要拆机配两个文件、跑一条 Docker 命令就能跑通。跑通之后你能得到什么先说结果。MiGPT 服务起来之后你的小爱音箱大概是这样问什么都能答小爱同学请解释一下光合作用它会分步讲清楚叶绿体、光反应而不是敷衍一句建议查阅资料。能装人设给它起名、写简介它就以第一人称跟你聊天比如我是傻妞很高兴认识你。连续对话说一声小爱同学召唤傻妞进入 AI 模式接下来几轮提问不用每次都用唤醒词开头。回复更自然AI 回复是流式下发的边说边答不用干等十几秒。改造前后大致是这样对比项原厂小爱音箱MiGPT 改造后问答能力固定技能超出范围就我还不会大模型加持开放问题都能接住对话体验一问一答长回复干等流式回复可连续多轮对话人设与记忆固定形象自定义角色带长短期记忆声音原厂 TTS可换第三方 TTS比如火山同款音色原理一句话能讲清的链路MiGPT 就像站在小爱音箱和大模型中间的翻译官数据流是这么走的监听——它通过小米 IoT 开放接口轮询音箱的对话列表拿到你说的话处理——把你的消息连同人设、聊天历史一起丢给大模型合成——把 AI 的回复交给 TTS 引擎变成语音播放——再通过音箱的 TTS 指令让小爱把这个声音念出来。更细的实现可以看仓库里的 docs/how-it-works.md这里不展开你只要记住上面这条监听→处理→合成→播放的链路就行。三步跑通环境、配置、启动第 1 步备好环境和项目你需要三样东西一台能装 Docker 的机器树莓派、NAS、云服务器都行、一个小米账号、一个大模型 API 密钥。注意 MiGPT 调的是小米云端接口服务器不用和音箱在同一局域网。然后把代码拉下来# 克隆 MiGPT 项目并进入目录 git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt为什么用 Docker 而不是直接跑源码因为源码方式还要装 Node 环境、生成数据库多两步就多两个出错点。Docker 镜像把所有依赖都打包好了配置外部挂载即可。第 2 步改两个配置文件项目里有两个示例配置把它们各复制一份、改名、填上你自己的信息这是最关键的几步。第一份是.migpt.js由.migpt.example.js复制改名管的是AI 是谁、音箱怎么连export default { bot: { name: 傻妞, // AI 自称的名字 profile: 性别女性格乖巧可爱喜欢搞怪爱吃醋。, // 人设简介 }, speaker: { userId: 987654321, // 小米 ID不是手机号/邮箱在个人信息页查 password: 你的小米密码, did: 小爱音箱Pro, // 米家 App 里的设备名注意空格和大小写 ttsCommand: [5, 1], // TTS 播放指令按音箱型号填写 wakeUpCommand: [5, 3], // 唤醒指令同上 }, };第二份是.env由.env.example复制改名管的是接哪个大模型OPENAI_MODELgpt-4o-mini # 模型名 OPENAI_API_KEYsk-xxx # 模型密钥占位符请替换 # OPENAI_BASE_URLhttps://api.openai.com/v1 # 换国产模型时改这里改完可以顺手做两件小事把bot.profile换成你想要的人设不接 OpenAI 而用通义千问、DeepSeek 等模型的话把OPENAI_BASE_URL和OPENAI_MODEL改成对应服务的地址和模型名即可变量名保持不变。所有参数的完整含义见 docs/settings.md。安全提醒.env里有密钥别把它提交到任何仓库小米账号建议用一个专用小号服务尽量跑在内网或加访问控制。第 3 步启动并喊它试一句# 挂载两个配置文件后台启动 MiGPT docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest为什么用-v挂载配置文件这样以后改配置不用重建镜像改完文件重启容器就生效。启动成功后对着音箱说小爱同学请问地球为什么是圆的。它先应一句提示语然后开始回答就说明链路全通了。想玩连续对话再说一句小爱同学召唤傻妞进入 AI 模式即可。把音箱调到顺手的状态跑通只是及格线接下来调一调体验会舒服很多。改 AI 的说话方式。编辑.migpt.jssystemTemplate是它的行为准则callAIKeywords决定哪些话会触发 AI。比如只让它回答以请傻妞开头的问题避免你随便闲聊都被接走speaker: { callAIKeywords: [请, 你, 傻妞], // 以这些词开头的消息才交给 AI wakeUpKeywords: [打开, 召唤], // 说这些词进入连续对话模式 exitKeywords: [退出, 再见], // 说这些词退出 AI 模式 streamResponse: false, // 连续对话开关型号不支持时务必关掉 }改指令参数。ttsCommand、wakeUpCommand每个音箱型号不一样填错了就是控制台有回复、音箱没声音。查法很简单在 docs/compatibility.md 里找你的型号抄参数表里没有就去小米 MIoT 规格站搜你的型号找到 TTS 和唤醒两个方法对应的数字填进去。还有一种情况AI 说到一半戛然而止。那是音箱型号查不准播放状态去同一张表里填上playingCommand试试换个声音。用腻了小爱原声可以在.env里配第三方 TTS 服务本地部署的 ChatTTS、火山 TTS 都行步骤在 docs/tts.md。避坑问答三个最高频的故障现象启动时报70016登录验证失败。原因userId填错了——它是小米 ID不是手机号或邮箱也可能是账号触发了异地登录保护。处理到小米账号个人信息页核对小米 ID异地登录问题先在运行 MiGPT 的同一网络下登录一次小米官网、手动通过安全验证等约 1 小时再试。现象报找不到设备xxx初始化失败。原因did和米家 App 里的设备名对不上常见是多了空格、大小写不同或把音箱写成音响。处理打开米家 App 复制设备名的原文粘贴进去仍不行就开debug: true和enableTrace: true从日志的 MiNA 设备列表里抄miotDID填入did。现象控制台能看到 AI 回复了但音箱一声不吭。原因ttsCommand填的不是你这个型号的 TTS 指令。处理到 docs/compatibility.md 按型号抄对应参数改完重启容器型号不在表里就去 MIoT 规格站自行查询。更多疑难杂症仓库里的 docs/faq.md 基本都有答案建议动手前先翻一遍。下一步行动对照 docs/compatibility.md 确认你的音箱型号和指令参数不在名单里的型号直接问自己一句值不值得折腾。通读 docs/settings.md把所有配置项过一遍尤其是连续对话相关的三个参数。跑通基础问答后去 docs/tts.md 折腾一个第三方音色这是成就感最强的一步。想理解监听→处理→合成→播放的底层细节读 docs/how-it-works.md有源码基础的话顺手看看 src/services/bot/ 的对话管理实现。最后提醒一句.env和.migpt.js里存着密钥和账号信息定期备份的同时别把它们同步到任何公开的地方。项目已停止维护核心功能稳定可用但别期待后续有新特性。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考