企业官网建设流程全解析

小爱音箱接入 ChatGPT 完整指南：5 步部署 MiGPT

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

你是不是也想过，让家里的小爱音箱别只会放歌，而是能像 ChatGPT 一样聪明地回答问题？开源项目 MiGPT 就是把小爱音箱接入 ChatGPT、豆包等大模型的桥梁，把它改造成你的专属语音助手。跟着本文，5 步就能完成全部接入。

🎯 核心能力速览：小爱为什么值得改造

• 🎓 AI 问答：接入大模型后上知天文下知地理，小爱从"人工智障"秒变学霸
• 🎭 角色扮演：自定义 AI 人设，贴心闺蜜、专属管家随心切换
• 💬 流式响应：回答边生成边播报，不用干站着等结果
• 🧠 长短期记忆：记得住对话上下文，越聊越懂你
• 🔊 自定义音色：可接第三方 TTS，换成"豆包"同款音色，像真人在回话

📋 动手前准备：一张清单

一句实在话：官方 README 注明项目已停止维护，但现有功能成熟稳定，下文所有步骤均按当前版本编写，放心照着做。

🚀 新手路线：5 步用 Docker 跑起来

Docker 路线不用搭 Node 环境，对新手最友好。

步骤1：获取项目代码

把仓库克隆到本地：

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

做完看到什么：目录里能翻到.env.example和.migpt.example.js两个示例文件，说明代码下载完整。

步骤2：创建配置文件

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

然后在.env里填上大模型的密钥和模型名：

OPENAI_API_KEY=你的API密钥 OPENAI_MODEL=gpt-4o-mini

做完看到什么：两个新文件出现在目录里，.env中这两行已填好真实值。

步骤3：配置音箱信息

打开.migpt.js，只需改 speaker 里的 5 处：

speaker: { userId: "你的小米ID", // 在「个人信息」-「小米 ID」查看 password: "你的小米账号密码", did: "小爱音箱Pro", // 米家APP里设置的名称 ttsCommand: [5, 1], // 语音指令，按你的型号查 wakeUpCommand: [5, 3], }

做完看到什么：两条指令数组与你音箱型号对上（小爱音箱 Pro 正是[5, 1]/[5, 3]），其他型号请查 docs/compatibility.md。

步骤4：安装并验证 Docker

docker --version

做完看到什么：终端打印出Docker version 24.x这样的版本号；没装的话先按你系统的官方 Docker 文档装好再回来。

步骤5：启动服务，开口说话

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

做完看到什么：docker ps里容器处于 running 状态。对着音箱说"小爱同学，请告诉我地球为什么是圆的"，如果它开始流式播报大模型的回答，恭喜，接入成功。

💻 进阶路线：Node.js 源码部署

适合想改代码、调参数或深入原理的开发者。

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install pnpm db:gen pnpm dev

做完看到什么：终端正常打出启动日志且无报错。改代码、断点调试的方法见 docs/development.md。

🔧 关键配置讲解：只需懂这 5 处

想接 OpenAI 以外的大模型？只需在.env里改OPENAI_BASE_URL接口地址，通义千问、Moonshot 等都支持 OpenAI 兼容接口。全部参数含义见 docs/settings.md。

🛠️ 排障清单：出问题按这个顺序查

• 服务起不来：先查服务器能否上网 → 再验证 API Key 是否有效 → 最后用docker logs看具体报错。
• 小爱音箱无反应：先核对小米 ID 和密码（不是手机号或邮箱）→ 再核对did是否与米家名称一字不差 → 最后重启音箱重试。
• AI 回答慢或超时：先换响应更快的模型 → 再查网络延迟 → 最后调大.migpt.js里的timeout。
• 连续对话被过早打断：先关掉streamResponse验证基础功能是否正常 → 再微调checkInterval与checkTTSStatusAfter。

🎨 进阶玩法与延伸阅读

• 家庭学习伙伴：在bot.profile写一段人设，比如"耐心的小学老师，讲解爱举例子"，让小爱陪孩子写作业。
• 换一副好声音：接第三方 TTS 换掉原声，教程见 docs/tts.md。
• 调教 AI 性格：重写systemTemplate系统 Prompt 控制语气与篇幅，见 docs/prompt.md。

想知道背后如何运转，读 docs/how-it-works.md；大部分疑问的答案都写在 docs/faq.md 里。

整条路并不难，你现在已经站在了终点门口。去对着音箱说出那句"小爱同学，请给我讲个笑话"吧，当它用大模型的声音接住你的话，你会觉得之前配置的每一步都值了。

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