小爱音箱秒变AI语音助手MiGPT从零到一完整接入教程【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt晚上七点孩子缠着你问为什么天空是蓝色的你却支支吾吾答不上来想查一下明天的天气还得先解锁手机打开App。如果家里那台吃灰的小爱音箱能像ChatGPT一样有问必答、还会记住你的喜好是不是瞬间省心多了这就是 MiGPT 在做的事把普通小爱音箱接入 ChatGPT、豆包等大语言模型让它从关键词复读机升级为真正会思考的专属语音助手。本文将以零基础视角带你完成环境准备、双文件配置、人设定制与常见问题排查半小时内让人工智障变身智能管家。一分钟看懂MiGPT 到底改进了什么MiGPT 的本质是一层翻译官它监听你对小爱音箱说的话把语音指令转交给大模型思考再把回答通过 TTS 播报出来。改造前后差异一目了然对比维度改造前的小爱MiGPT 加持后理解方式关键词匹配答非所问语义理解听懂潜台词知识储备固定内置库大模型海量知识随叫随到对话模式一问一答支持唤醒模式连续畅聊记忆能力不记得你是谁长短期记忆越聊越懂你声音风格固定音色可换第三方 TTS 音色角色性格千篇一律深度人设量身定制一句话总结改造的不是硬件而是大脑。你不需要拆机刷固件只靠配置文件就能重塑它的灵魂。快速上手3分钟跑通最小可用配置第一步备好三样东西一台小爱音箱推荐 Pro 型号兼容性最好Node.js 16 环境或用 Docker 直接部署一个小米账号注意是小米 ID不是手机号或邮箱第二步拉取代码并初始化配置git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install # 或使用 npm install cp .env.example .env cp .migpt.example.js .migpt.js 小贴士嫌装环境麻烦Docker 用户只需执行docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest一行命令即完成部署Windows 终端记得把$(pwd)换成绝对路径。第三步启动并验证pnpm start看到类似Speaker 服务已启动...的日志后对小爱说一句小爱同学请问地球为什么是圆的如果它给出了大模型级别的完整回答恭喜你改造成功核心配置拆解两个文件掌控全局文件一.env —— 决定用谁的大脑这是大模型服务的开关OpenAI 系的配置方式如下OPENAI_MODELgpt-4o-mini OPENAI_API_KEYsk-你的密钥 OPENAI_BASE_URLhttps://api.openai.com/v1想用国产模型只需要把三个变量的值换成对应服务商的信息变量名完全不用动。以通义千问为例OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1 OPENAI_MODELqwen-turbo OPENAI_API_KEY通义千问的密钥豆包、DeepSeek、Kimi 等模型的接入套路完全一致理论上兼容 OpenAI SDK 的模型都能接。⚠️ 易踩的坑OPENAI_BASE_URL一般要以/v1结尾抄错地址会出现 404 Not Found另外国内网络直连 OpenAI 服务不稳定建议优先使用国产模型或配置HTTP_PROXY代理。文件二.migpt.js —— 决定怎么对话这个文件管音箱连接和 AI 人设最核心的三块export default { bot: { name: 傻妞, profile: 性别女性格乖巧可爱喜欢搞怪 }, master: { name: 陆小千, profile: 性别男善良正直 }, speaker: { userId: 987654321, // 小米 ID不是手机号 password: 123456, // 账号密码 did: 小爱音箱Pro, // 米家 App 中的设备名称 ttsCommand: [5, 1], // TTS 播报指令 wakeUpCommand: [5, 3], // 唤醒指令 callAIKeywords: [请, 你, 傻妞], wakeUpKeywords: [召唤, 打开], exitKeywords: [退出, 再见], }, };字段含义一句话版bot和master是扮演角色与主人的人设介绍speaker里的关键词决定了哪些话会触发 AI。⚠️ 易踩的坑userId填手机号是新手第一坑请在小米账号的「个人信息」页查看小米 IDdid必须和米家 App 中的名称一字不差音响和音箱、Pro的空格大小写都会导致找不到设备报错。不同型号小爱音箱的ttsCommand指令可能不同可前往 miot-spec 查询设备规格文档核对查询到设备服务表后将play-text对应的 AIID 填入ttsCommandwake-up对应的 AIID 填入wakeUpCommand进阶玩法让人设活起来的三个实战场景场景一给孩子定制一个学习伙伴把bot.profile改成温柔耐心的老师喜欢用讲故事的方式回答问题再配合systemTemplate里的 Prompt 模板约束回答风格孩子问为什么有四季音箱会先讲一个小故事再解释原理。官方还提供了现成的 Prompt 模板示例见 docs/prompt.md。场景二开启唤醒模式实现免唤醒连续对话配置好wakeUpKeywords后说一句小爱同学召唤傻妞即进入唤醒模式之后无需每次都以小爱同学开头连续提问也能记住上下文。onEnterAI、onAIReplied等提示语字段可以自定义比如把我说完了改成主人还有问题吗。场景三给音箱换个新嗓子默认使用小爱自带音色想体验豆包同款嗓音在.env中配置TTS_BASE_URL指向第三方 TTS 服务再把speaker.tts改为customspeaker: { tts: custom, switchSpeakerKeywords: [把声音换成], }之后只需说小爱同学把声音换成甜美台妹即可实时切换音色具体接入方式见 docs/tts.md。另外当小爱在长文本回复时被抢话或戛然而止可参考播放状态检测配置调整playingCommand高频问题排查速查表现象可能原因解决办法提示70016 登录验证失败小米 ID 填成了手机号去账号个人信息页核对小米 ID 后重试提示找不到设备xxxdid 名称与米家不一致直接复制米家 App 中的设备名称AI 没响应但控制台有输出TTS 指令与型号不匹配按本文方法查询并修正ttsCommand回复中途戛然而止播放状态查询指令缺失配置playingCommand或关闭streamResponse提示LLM 响应异常 401API 密钥无效检查.env中密钥是否生效回答速度太慢模型较重或提示语拖沓换gpt-4o-mini等快模型关闭onAIAsking提示语触发异地登录保护账号在新设备登录在运行 MiGPT 的网络环境登录小米官网完成安全验证更多冷门问题的解答可翻阅 docs/faq.md 和 docs/settings.md。总结从能对话到懂你只差这一步MiGPT 的改造路径并不复杂一个.env决定大脑一个.migpt.js决定性格剩下的交给大模型自由发挥。你可以让它当家庭教师、深夜陪聊的伙伴或是只属于你的专属管家——上限由你的想象力决定。建议动手前先想清楚两件事你想让它扮演什么角色以及你希望它用哪种声音回应你想清楚后立刻按本文步骤操作今晚就能听见你的小爱说出第一句有温度的回答。如果中途遇到问题对照速查表逐项排查即可多数情况只需改一行配置就能解决。现在去唤醒你的智能管家吧。✨【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考