MiGPT 从 0 到 1 部署教程：小爱音箱接入大模型，打造你的智能音箱 AI 助手

MiGPT 从 0 到 1 部署教程小爱音箱接入大模型打造你的智能音箱 AI 助手【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt家里的小爱音箱只会放歌、问点别的就答非所问MiGPT 能把它接入大语言模型让普通小爱音箱也能自然对话。这篇 MiGPT 部署教程带你从 0 到 1装环境、配.env、选模型、调参数、排故障一步步把它调成你的智能音箱 AI 助手。先看它能干啥说白了MiGPT 就是给小爱音箱装了个AI 大脑。你喊小爱同学请 xxx它不再只会答预设指令而是调用大模型理解你的话再用 TTS 念回来。装上之后变化主要有这么几个自然对话能上知天文下知地理问啥都能聊不再是人工智障。连续对话进入唤醒模式后不用每句都喊小爱同学可以连着问。角色设定一句话给它立人设你是傻妞语气、性格随你定。长短期记忆它能记住你们聊过的细节越用越懂你。换音色接第三方 TTS 后音色不再只有小爱那一种。你的设备在名单里吗先别急着装MiGPT 只支持小米生态的小爱音箱小度、天猫精灵、HomePod 都不在名单里也没适配计划。不同型号支持程度差很多核心差别在于能不能查到设备的播放状态——能就能开连续对话不能就只能整句播报。设备支持度注意点推荐度小爱音箱 ProLX06✅ 完美运行官方首选连续对话最稳⭐⭐⭐⭐⭐Xiaomi 智能音箱 ProOH2P、小米 AI 音箱S12等✅ 完美运行要配对应ttsCommand/wakeUpCommand⭐⭐⭐⭐⭐小爱音箱 PlayL05B、miniLX01等 正常运行查不到播放状态关掉streamResponse⭐⭐⭐小米小爱音箱 HDSM4、蓝牙随身版❌ 不支持无适配计划⭐小度 / 天猫精灵 / HomePod❌ 不支持仅支持小米生态—购买前怎么查规格打开米家看设备的名称和型号比如LX06对照 兼容型号列表具体的指令参数play-text、playing-state对应的 siid/piid要到小米 MIoT 规格站按型号查。型号对得上基本就稳了。从 0 到 1把 MiGPT 装起来一条线走下来就行不折腾。1. 环境准备跑源码装 Node 20 pnpm。跑 Docker装好 Docker 即可。一个小米账号记住登录用的是小米 ID不是手机号/邮箱 一台上面的小爱音箱。2. 拉代码装依赖源码方式Docker 可直接拉镜像git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install pnpm build3. 配账号与.env.env.example复制成.env填模型信息国内服务示例详见 参数设置OPENAI_API_KEY你的密钥 OPENAI_MODELqwen-turbo OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1.migpt.example.js复制成.migpt.js配设备speaker: { userId: 小米ID, // 不是手机号/邮箱 password: 账号密码, did: 小爱音箱Pro, // 和米家中设备名一字不差 ttsCommand: [5, 1], wakeUpCommand: [5, 3], }4. 启动验证# 源码方式 pnpm dev # 或 Docker 方式 docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest对着音箱说小爱同学请 介绍一下你自己听到它用大模型的味道回答你就成了。把体验调到位模型和参数怎么选模型怎么选看你的网络和环境国内服务通义千问 / DeepSeek / Moonshot / 零一万物延迟低、稳定国内首选。本质就是把OPENAI_BASE_URLOPENAI_MODEL换成服务商的兼容地址OPENAI_API_KEY换成对应密钥即可。OpenAIgpt-3.5 / gpt-4o效果好但国内要配代理新账号未绑卡可能用不了 4o 系列。本地 Ollama / LM Studio隐私拉满、不花钱起一个 OpenAI 兼容服务把OPENAI_BASE_URL指向localhost就行但机器要给力响应比线上慢。关键参数怎么调都在.migpt.js里完整说明见 参数设置参数建议值作用适用场景streamResponsetrue / false连续对话流式响应开关能查播放状态的机型开查不到的关保证整句checkInterval500默认 1000连续对话的播放状态检测间隔越低停顿越小想更跟手、网络稳checkTTSStatusAfter3别低于 1下发 TTS 后多久开始检测播放状态衔接卡顿可微调exitKeepAliveAfter30连续对话无响应多久自动退出防止一直占用callAIKeywords/wakeUpKeywords[请,傻妞]/[召唤]触发 AI、进入唤醒模式的词想要更自然的召唤方式ttsCommand/playingCommand按型号查如[5,1]TTS 播报、查询播放状态的指令没声音 / 读一半停systemTemplate默认带上下文记忆系统 Prompt控制人设与上下文想改人设、省 token 可精简出问题了怎么修这里有个坑十有八九的故障都卡在账号、没声音、慢这三类。按现象 → 原因 → 动作来查更多见 常见问题现象可能原因解决动作70016 登录验证失败账号密码错或误用了手机号/邮箱用小米 ID重新填提示异地登录保护触发了小米安全验证同网络环境下官网登录过验证等约 1 小时终极方案本地登录成功后导出.mi.json挂载到容器提示找不到设备did和米家不一致错别字/空格/大小写直接复制米家中设备名不行就开debugenableTrace填设备did有回复但音箱没声音ttsCommand配错按型号到 MIoT 规格查正确指令回答戛然而止、读一半停机型查不到播放状态配playingCommand查不到就关掉streamResponse响应慢 /LLM Connection error网络或代理问题调小checkInterval、换快模型配HTTP_PROXY或换国内服务小技巧它回答太啰嗦直接喊小爱同学请你闭嘴就能打断。再往前走一步装好能跑之后这些进阶玩法可以按需上本地模型用 Ollama 或 LM Studio 起 OpenAI 兼容服务把OPENAI_BASE_URL指到localhost数据完全不出门。记忆机制长短期记忆逻辑在 记忆模块默认把最近约 10 条对话记忆带进 Prompt。想省 token可在systemTemplate里精简或关掉上下文。️自定义存储默认用 Prisma SQLiteprisma/app.db要换库改 数据层 即可。安全别把它暴露到公网限本地访问.env含密钥别外传建议 600 权限定期清理对话历史。另外调用小米接口存在账号封禁等风险用前心里有数。注意项目目前已停止维护升级依赖前先看 更新日志用固定版本更稳。 下一步做什么新手先把streamResponse和checkInterval调顺能连续对话就算成。进阶换国内模型 精简systemTemplate把响应速度和 token 都压下来。开发者改 记忆模块 和 数据层做出自己的玩法。后续更新和路线图盯 更新日志 和 Roadmap 就行。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考