MiGPT：3步把小爱音箱接入ChatGPT，改造成你的专属AI语音助手
【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt
深夜你问"小爱同学，天空为什么是蓝色的"，音箱没有念罐头话术，而是用像真人一样的声音给出解答，之后你还能连续追问。这就是 MiGPT 想带给你的场景：把小爱音箱接入 ChatGPT、豆包等大模型，让普通智能音箱变成能对话的 AI 语音助手，适合手里有小爱音箱、想折腾智能家居的你。
项目速览：MiGPT 是什么
MiGPT 是通过小米开放接口给小爱音箱接上大模型的开源项目：轮询获取你的语音消息，调用大模型生成回复，再合成语音让音箱播放出来。核心亮点有：
- AI 问答：上知天文下知地理，随口提问都有靠谱回答
- 角色扮演：配置人设后，音箱能当倾听心事的伴侣、专业顾问
- 流式响应：回复即时返回，不用干等
- 长短期记忆：记得你们聊过的内容，越聊越懂你
- 自定义 TTS：可接第三方语音合成，音色更像真人
上手前准备：环境、硬件与账号清单
| 项目 | 要求 |
|---|---|
| 硬件 | 大部分型号小爱音箱（推荐小爱音箱 Pro），不支持小度、天猫精灵 |
| 部署环境 | Docker，或 Node.js 16+（pnpm 7+），服务器内存建议 2GB 以上 |
| 小米账号 | 账号密码 + 小米 ID（在账号个人信息页查看，不是手机号或邮箱） |
| 设备信息 | 米家 App 中音箱的设备名称，或设备 did |
| AI 服务 | OpenAI API Key，或通义千问等国内厂商的兼容接口 |
动手前建议先在 MIoT 规格站搜一下你的音箱型号（如 lx06），把 TTS、唤醒指令参数记下来，配置时直接填，省得来回改。
快速上手三步走：克隆、配置、启动
第一步：获取项目文件。把仓库克隆到本地工作目录：
git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt第二步：准备两个配置文件。复制模板文件：
cp .env.example .env cp .migpt.example.js .migpt.js关键参数按文件分开填：
.env：填OPENAI_API_KEY与OPENAI_MODEL，用国内模型就只改OPENAI_BASE_URL的值.migpt.js：填userId（小米 ID）、password、did（米家里的设备名称）、ttsCommand和wakeUpCommand
第三步：Docker 启动。一条命令拉起服务：
docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest注意两点：Windows 终端下$(pwd)不可用，要换成绝对路径；控制台出现"服务已启动"即代表就绪。如果你是 Node.js 开发者，也可以 npm 安装后用MiGPT.create启动。
核心功能拆解：让小爱变身 AI 语音助手
把音箱变成 AI 问答箱
让音箱回答普通小爱答不上来的复杂问题。用法：说"小爱同学，请告诉我地球为什么是圆的"，以callAIKeywords（如"请"）开头的消息都会触发 AI 回复。
召唤小爱进入连续对话
进入 AI 模式后，不用每句都说"小爱同学"，像跟人聊天一样连续追问。用法：说"小爱同学，召唤傻妞"，30 秒无回应会自动退出，随时可再召唤。
给小爱设定角色人设
在配置里写好人物设定，AI 就会按这个人设的语气风格回答。用法：修改.migpt.js里的bot.profile和master.profile，也可以直接说"小爱同学，你是 xx，你喜欢 xx"随时调整。
接入第三方 TTS 换掉机械音
音箱可以用更像真人的音色来回复。用法：按 docs/tts.md 配置 TTS 服务接口，还支持用语音指令切换音色。
常见问题与避坑：启动失败、没声音、说一半
Q：启动提示"70016：登录验证失败"
A：多半是小米 ID 填错了，它不是手机号或邮箱，要到小米账号个人信息页查看；若触发"异地登录保护"，先在和 MiGPT 相同的网络下登录小米官网通过安全验证，等约 1 小时再重启。
Q：AI 有回复，但音箱不播放
A：不同音箱型号的 TTS 指令不一样。到规格站查你的型号，把ttsCommand值（如 [5, 1]）改到.migpt.js里。
Q：回复说到一半戛然而止
A：部分型号查不到播放状态，容易提前截断。把playingCommand改为 [3, 1, 1] 试试；仍不行就关闭streamResponse强制完整回复，代价是失去连续对话。
Q：对着小爱说话没反应
A：注意时机，小爱处于监听状态才听得到，Pro 型号顶部指示灯常亮就是在听；没反应时用"小爱同学，xxx"重新唤醒即可。
Q：OpenAI 接口连不上
A：国内网络访问 OpenAI 需要配HTTP_PROXY代理，或改用国内大模型厂商并更新OPENAI_BASE_URL。
延伸资源：文档与求助渠道
- docs/compatibility.md：兼容的小爱音箱型号与指令参数表
- docs/settings.md：全部配置参数说明
- docs/prompt.md：系统 Prompt 与人设设置教程
- docs/faq.md：更多高频问题解答
遇到新问题，建议先在项目 issue 列表里搜一搜，多数问题都有现成答案。
MiGPT 把成熟的 AI 大脑接进你家里现成的智能音箱，成本只是一条 Docker 命令。填好两份配置，你的家庭 AI 语音助手就上岗了。
【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
