企业官网建设流程全解析

小爱音箱接入 ChatGPT 完整指南：MiGPT 一条命令跑起来

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

MiGPT 是把小爱音箱接入 ChatGPT、豆包等开源大模型的项目。两个配置文件加一条 Docker 命令，你的音箱就能用大模型口径跟你说话：问答、角色扮演、还能记住上下文。不用写代码，全程 10 分钟。

🎯 它到底能替你干什么

跑起来之后，三种玩法直接可用：

1. 随便问。你："小爱同学，地球为什么是圆的？" 音箱用大模型给你的讲解，比小爱自带的 canned 回答像话得多。
2. 立人设再聊。你："小爱同学，召唤傻妞"，它切进角色，后面的追问都不用再喊"小爱同学"。
3. 当家庭助理。你："小爱同学，写几句关于春天的诗"，它现场生成一段念给你听。

注意：每句话必须"小爱同学"开头唤醒，这是固件写死的，改不了。

🚀 最短路径跑起来

主推 Docker，三步：

1. 克隆项目：git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
2. 把.env.example改名为.env、.migpt.example.js改名为.migpt.js，填上模型 API 密钥、小米 ID、密码、音箱名称。
3. 在项目目录执行：

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

启动后对音箱说"小爱同学，请讲个笑话"验证一下。Windows 终端下$(pwd)不生效，换成配置文件绝对路径。备选路线一句话带过：写 Node 的话npm install mi-gpt也能跑，但配置要手动传参，新手不必走。

MiGPT 以 Docker 方式运行，终端可见音箱上线状态与对话日志

🔊 上手后最顺手的几件事

• 连续对话。"小爱同学，召唤傻妞"进入模式后，追问不用重复唤醒词；回答太长没完没了，一句"小爱同学，请你闭嘴"就能打断。
• 有记忆。它记得你前面聊过什么，追问不用重新解释，越用越顺手。
• 换音色。默认用小爱自带 TTS，接上第三方 TTS 服务就能换成豆包同款音色。你："小爱同学，把声音换成 xxx"，当场切换。

接入大模型后，音箱支持的唤醒、对话与打断指令一览

按你的口味调

最值得动的 3 个配置，都在 docs/settings.md 里：

• 换模型：.env里改OPENAI_BASE_URL、OPENAI_MODEL、OPENAI_API_KEY三个值就能接通义千问、DeepSeek、豆包，变量名不变，只换值。
• 换人设：bot.profile决定助理性格，callAIKeywords决定哪些词开头会触发 AI 回答。
• 换音色：配好TTS_BASE_URL并把speaker.tts设为custom，步骤见 docs/tts.md。

🛠 卡住了先查这儿

1. 提示"70016：登录验证失败" → 小米 ID 填成了手机号。小米 ID 不是手机号或邮箱，去"个人信息"里查出来重填。
2. 提示"找不到设备：xxx" → 设备名和米家对不上。直接复制米家里的音箱名称，错别字、空格、大小写都会出错；型号和对应指令见 docs/compatibility.md。
3. 回答声音被截断、总是戛然而止 → 不同型号ttsCommand、playingCommand不同，查你型号的指令填进.migpt.js。其余报错去 docs/faq.md 搜，覆盖 90% 的问题。

适合谁用

家里有小米账号、大模型 API 密钥、一台小爱音箱，这三样齐了它就是你最短的改造路径；小度、天猫精灵不在这个范围内，音箱型号不在兼容列表里的也建议先按兵不动。本项目已停止维护，作者推荐迁移到后继项目 MiGPT-Next，动手前可以先查一下 docs/faq.md 里的已知问题。

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