企业官网建设流程全解析

小爱音箱接入大模型语音助手：MiGPT 入门教程，3 步搭好你的专属管家

【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt

MiGPT 是一个开源项目，把小爱音箱接入 ChatGPT、豆包等大模型，让它从只会执行固定指令，变成一个能连续对话、有人设、有记忆的智能音箱语音助手。不用改硬件、不用刷机，有台小爱音箱和会复制命令，就能跟着本文跑起来。

🌙 深夜哄睡前的那一问

晚上十点半，孩子躺在床上突然问："爸爸，月亮为什么会跟着我们走？"你随口讲了两句，对方已经迷迷糊糊。要是那一刻，旁边的小爱音箱接过话头，用温柔的语气把这个问题讲完呢？

MiGPT 干的就是这件事：不换新设备，把你手里那台小爱音箱，接上你指定的大模型。

📦 项目速览

MiGPT（仓库名 mi-gpt）基于 Node.js 开发，通过小米云端接口轮询小爱音箱的语音消息，把符合规则的问题转给大模型，再让音箱把回答朗读出来。它自带短长期记忆、流式回复和自定义人设，支持小爱音箱的大部分型号，推荐小爱音箱 Pro（运行最稳定）。注意：小度、天猫精灵、HomePod 等其他品牌音箱暂不支持。

📋 准备工作清单

• 一台小爱音箱（推荐小爱音箱 Pro，兼容列表见 兼容性文档），且已绑定到你的小米账号
• 你的小米账号，登录密码要手边备好
• 小米 ID（在"个人信息"页查看，注意：不是手机号或邮箱，填错是最常见的翻车点）
• 音箱在米家 App 里显示的设备名称，比如"小爱音箱Pro"
• 大模型 API 密钥：OpenAI 的，或通义千问、DeepSeek 等国产模型的均可
• 运行环境：Docker，或 Node.js 16 及以上

🚀 上手流程

1. 获取项目代码：

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt

预期结果：当前目录下出现README.md、.migpt.example.js等文件。

2. 复制两份配置文件并填写：

cp .migpt.example.js .migpt.js cp .env.example .env

然后在.env里填上你的模型密钥和接口地址，在.migpt.js里填小米 ID、密码和设备名称。各字段含义可对照 参数设置文档。 预期结果：两个配置文件保存成功，无语法报错。

3. 启动服务：

pnpm install pnpm start

预期结果：控制台打印"服务已启动"，对着音箱说"小爱同学，召唤傻妞"（默认唤醒词），它会应声报出你的 AI 名字。

4. 验证对话。依次试试三种说法：
   • "小爱同学，请介绍一下你自己"
   • "小爱同学，你喜欢我吗"
   • "小爱同学，召唤傻妞"，进入后可直接连续提问，不再需要每句都喊"小爱同学" 预期结果：音箱用大模型生成的内容回答，而非原来的模板应答。

⚙️ 最值得调的配置

人设（bot 与 master）：这是体验提升最大的一处。.migpt.js顶部的botProfile决定 AI 的性格，masterProfile决定它对"你"的称呼与态度。改成"性别：女，性格：温柔耐心，擅长把复杂问题讲得简单"，同一个模型，语气就完全不一样。

如何配置唤醒词：speaker.wakeUpKeywords控制进入 AI 模式的话术，exitKeywords控制退出。嫌"召唤傻妞"拗口，换成你给 AI 起的名字即可，比如["打开小智", "召唤小智"]，改完重启服务生效。

模型（OPENAI_MODEL）：填在.env里，决定"脑子"是谁。OpenAI 官方模型直接填；用国产模型时，把OPENAI_BASE_URL改成对应服务的接口地址即可，环境变量名保持不变，无需改代码。

第三方 TTS（可选）：嫌小爱默认音色出戏，可自建或部署一个 TTS 服务，在.env填TTS_BASE_URL，再把speaker.tts设为custom，之后说"小爱同学，把声音换成 xxx"就能切换音色，步骤详见 TTS 文档。

🛋️ 生活化玩法

睡前故事机。哄孩子时说一句"小爱同学，请给我讲一个关于月亮的故事"，它会把故事拆成一段段慢慢念出来；听腻了，"小爱同学，请你闭嘴"即可打断，再换个主题继续，比你自己编故事省力多了。

晨间播报。设好闹钟醒来后，"小爱同学，请告诉我今天天气"，它会结合你的城市组织成一句自然的口头播报，而不是照读数据。

客厅陪聊。客人来访时"小爱同学，请介绍一下北京的前身"，让音箱客串讲解员；你也可以用"小爱同学，你是……，你……"的句式临时给它换人设，比如让它扮演一位严谨的导游，全程用第三人称视角讲景点。

❓ 常见问题

Q：启动时报"70016：登录验证失败"？

• 检查小米 ID 是否填错，它不是手机号也不是邮箱
• 可能是触发了异地登录保护，在同一网络下登录小米官网通过安全验证，约 1 小时后再试

Q：对小爱说话没有 AI 回复？

• 必须先唤醒再说，"小爱同学，请 xxx"，直接说"请 xxx"是无效的
• 确认消息开头命中了callAIKeywords列表里的词（默认"请""你"等）

Q：回答说到一半戛然而止？

• 你的型号需要配置播放状态查询指令playingCommand
• 到 home.miot-spec.com 查你型号的指令编号，照 播放状态配置 的方式填入配置文件

Q：国内访问 OpenAI 报 Connection error？

• 在.env填HTTP_PROXY代理地址
• 或改用通义千问、DeepSeek 等可直接访问的国产大模型

🔭 进阶方向

跑通基础功能后，还有几件事值得试：接入第三方 TTS 换掉默认音色、把大模型换成 Ollama 本地部署的私有模型、参考 Unraid 部署教程 把服务挪到 NAS 上 7x24 小时常驻，以及研究 工作原理文档 理解消息轮询与记忆系统的实现细节。

一句话总结：MiGPT 用不到 10 分钟，让吃灰的小爱音箱接上大模型，变成随叫随到的语音管家。

• 参数设置文档
• 常见问题
• 核心源码

【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt