企业官网建设流程全解析

10 分钟把小爱音箱变成 AI 语音助手：MiGPT 保姆级上手指南

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

凌晨一点，被冰箱的嗡鸣吵醒，你翻身摸出手机想搜"发烧要不要吃退烧药"，屏幕的光刺得眼睛疼。MiGPT 把小爱音箱接进 ChatGPT 这类大模型，让智能家居语音助手从"只会念固定台词"变成能跟你聊天的样子。

它帮你省掉了什么

以前你夜里每冒出一个问题，都得摸出手机、解锁、打字、盯着屏幕等回复，一套做完，困意 gone 了一半。现在你只需要抬嗓子说一句"小爱同学，这是什么"，答案就从音箱里直接飘过来。在手机上操作这套流程要三分钟，用嘴说，十秒以内。以前小爱只能应付固定台词，聊两句就"我不知道"；现在它能陪你聊很久，记得你说过的事，越用越默契。对有娃的家庭来说，这意味着吃饭和睡前各少一部手机，家里多一个能接住话的人。

动手前的清单

• 一台小爱音箱（Pro 兼容性最佳）
• 能跑 Docker 的电脑或 NAS
• 一个小米账号加一个模型密钥
• 能访问模型服务的网络

每个参数的含义见 docs/settings.md。东西备齐了，往下看。

三步跑起来：语音助手就位

第 1 步：把项目代码弄到手

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

第 2 步：备好两个配置文件

把 .env.example 改名成 .env，填上你要用的大模型密钥；把 .migpt.example.js 改名成 .migpt.js，填上小米账号和米家里设置的音箱名称（注意：userId 是小米 ID，不是手机号）。

第 3 步：一条命令启动

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

走过去说句"小爱同学，请讲个冷知识"，音箱里传出像人说的话，就成了。🚀

改这三行，智能家居体验翻倍

默认配置能跑，但默认的腔调像"客服在岗"。打开 .migpt.js，只动这三行：

• 把systemTemplate改成"你是这个家的管家，回答温暖简洁一点"，音箱开口就不再是冷冰冰的客服腔。
• 把callAIKeywords改成["请", "喂"]，随口一句"喂"就能把 AI 喊出来，不用背咒语。
• 把tts改成custom再接个第三方语音服务，它说话就是豆包同款音色，不再是标准小爱音。

保存后重启服务，音箱的性格就换人了。

它的一天

早晨。你刚醒，脚还没落地就问"小爱同学，今天天气怎么样"，它把天气和要不要带伞一句话念给你。脚落地了，手机还躺在抽屉里。

傍晚。你站在厨房，手上沾着面粉，问它"天空为什么是蓝色的"，它几秒钟就讲完。吃饭时没人需要低头看屏幕了。

深夜。孩子问"昨晚的故事怎么断了"，它记得之前聊到哪，接着昨晚的悬念往下讲。屋子里像真有人。

翻车急救 🛟

• 音箱没反应 → 先确认米家 App 里设备在线，再重启 MiGPT 服务
• 提示 70016 登录失败 → userId 不是手机号，去「个人信息」查小米 ID 重填
• 提示找不到设备 → did 跟米家里名称对不上，原样复制，连大小写一起
• 回答说到一半断掉 → 型号不支持播放状态查询，改 playingCommand 或换 Pro
• AI 回复太慢 → 把 onAIAsking 和 onAIReplied 提示语设成空数组，换个快模型

没列进去的毛病，十有八九在 docs/faq.md 里已有答案。

凌晨一点，冰箱还在嗡，但你只需要抬抬嗓子，答案就送到了枕头边。觉得有用，去仓库点个 Star。

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