企业官网建设流程全解析

3分钟把小爱音箱改造成AI语音助手：MiGPT快速上手

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

问小爱音箱"天空为什么是蓝色的"，它回你一段套话——难怪被人叫"人工智障"。MiGPT 就是来解决这件事的：把小爱音箱接入 ChatGPT、豆包等大模型，改造成真正会聊天的 AI 语音助手，全程改造只需 3 分钟。

改造完能干什么？

先看效果，再决定值不值得折腾：

• 复杂对话：多轮追问、长句理解，不再"听不懂，请再说一遍"；
• 角色扮演：一句"扮演一位旅行顾问"，人设立马上线；
• 对话记忆：内置长短期记忆，越聊越懂你；
• 换掉原声音色：支持接入第三方 TTS，音色不再只有小爱默认那一种。

小爱音箱AI改造准备清单

• 确认机型在支持列表内：小爱音箱 Pro（体验最好）、小米 AI 音箱（第二代）、小爱音箱 Play、小爱智能家庭屏 10 等，完整型号见 兼容列表；
• 备好消息小米账号的密码，以及小米 ID（不是手机号、不是邮箱）；
• 备好用得上的大模型 API Key（OpenAI 或国产模型均可）；
• 把项目克隆到本地：

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

MiGPT Docker部署，一条命令搞定

Docker 是最快的路子，不用折腾 Node 环境，一条命令直接跑：

docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest

大白话解释：--env-file是把当前目录下的.env（AI 模型配置）读进容器；-v是把.migpt.js（小米账号配置）映射进容器。唯一注意：Windows 终端里$(pwd)不生效，换成文件的绝对路径就行。

MiGPT配置详解：只改两处

先在项目根目录复制两个模板：.migpt.example.js改成.migpt.js，.env.example改成.env。

1. 小米账号（.migpt.js里，就关心 3 个字段）：

speaker: { userId: "987654321", // 小米 ID，不是手机号或邮箱 password: "你的账号密码", did: "小爱音箱Pro" // 设备名，从米家App直接复制 }

2. AI 模型（.env里）：填OPENAI_API_KEY（密钥）、OPENAI_MODEL（模型名）、OPENAI_BASE_URL（接口地址）。除 OpenAI 外，凡是兼容 OpenAI SDK 的模型都能直接用，如通义千问、Moonshot 等；豆包这类模型经第三方 API 网关转换后也能接。完整字段说明看 参数设置。

实测验证与避坑清单

三个方法确认改造成功：

1. 基础问答："小爱同学，请问地球为什么是圆的？"
2. 唤醒模式："小爱同学，召唤 AI 助手"，进入后连续提问不用每句都喊唤醒词；
3. 角色测试："扮演一位旅行顾问，给我推荐行程"。

常见坑按"现象 → 原因 → 解决"对号入座：

• 启动报"70016 登录验证失败"：账号密码填错，或触发了小米异地登录风控；核对小米 ID，并在与容器相同的网络下手动登录一次小米账号通过安全验证。
• 提示"找不到设备"：did和米家设备名不一致，多半是多打空格或错别字；从米家 App 里直接复制名称。
• 语音说到一半戛然而止：机型查不到播放状态导致；按 FAQ 查playingCommand配置，或关闭流式响应换完整回答。
• 说话没反应：没唤醒小爱它听不见；先说"小爱同学，请 xxx"再提问，正在放歌时记得先暂停。

一句话总结：3 分钟的配置，换一台真正听得懂人话的 AI 语音助手，值得每台小爱音箱折腾一次。现在就 clone 下来，今晚就能开聊。

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