小爱音箱接入 ChatGPTMiGPT 30 分钟上手指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt周五晚上八点客厅里孩子在问小爱同学为什么月亮晚上会跟着我走音箱用预设的套路话术应付了一句孩子皱起眉头。如果你也遇到过类似的瞬间MiGPT 这个项目值得看一眼——它做的事情不复杂把 ChatGPT 或豆包这类大模型的大脑接进小爱音箱让音箱用你自己的声音、自己的设定回答真问题而不只是查天气放歌。MiGPT 能做到什么它本质上是一个常驻服务监听小爱音箱收到的语音指令把命中关键词的问题转给大模型再把回答转成语音播回音箱。围绕这个核心链路它顺带解决了几件日常很实用的事使用场景对应能力一句话说明随口问知识、问生活大模型问答换掉固定话术回答有上下文、有逻辑睡前陪聊、语音倾诉角色扮演与人格设定给 AI 起名、写人设说话风格随你定连续追问多轮唤醒模式与连续对话进入 AI 模式后不必每句都说小爱同学聊过就忘的尴尬长短期记忆对话历史被保存越聊越接得住听腻了默认音色第三方 TTS 接入可换火山引擎等音色语音更像真人服务跑起来之后终端里会看到类似上图的日志唤醒、召唤、应答逐条打出来方便你确认链路是通的。动手前的五件事开工前花两分钟对照自查能省掉后面大半的排错时间☑ 家里有一台米家体系的小爱音箱Pro 最稳多数型号可跑☑ 有小米账号且知道小米 ID在哪查不是手机号或邮箱☑ 有一台能常开的电脑或服务器4GB 内存起步☑ 机器上装好了 Docker或者熟悉 Node.js 20☑ 手里有一个大模型的 API KeyOpenAI 或任意兼容接口均可顺带提醒这个项目只服务小米音箱生态小度、天猫精灵、HomePod 不在范围内。主流程从零到小爱会回答问题先把 Docker 装好环境准备就一件事确认docker --version有输出。已有 Docker 的可以直接跳过后面所有步骤都基于它。拉下代码并复制配置模板git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .migpt.example.js .migpt.js cp .env.example .env复制出来的.migpt.js管音箱侧账号、设备、指令.env管模型侧Key 和模型名分工很清楚。填对小米账号与音箱名打开.migpt.js只需要认真核对这几行export default { speaker: { userId: 987654321, // 小米 ID去账号页个人信息里查 password: 账号密码, did: 小爱音箱 Pro, // 米家里的设备名逐字复制 ttsCommand: [5, 1], // 播放文字指令 wakeUpCommand: [5, 3], // 唤醒指令 }, };did最容易出错打开米家 App进入音箱主页右上角更多 → 设备名称直接复制原文。小爱音响和小爱音箱一字之差就会找不到设备。ttsCommand和wakeUpCommand不同型号数值不同照抄示例只对部分机型有效。查法是在小米 IoT 规格站搜你的型号比如 LX06找到 Intelligent Speaker 方法表图里红框标出的play-textAID 1对应ttsCommandwake-upAID 3对应wakeUpCommand前面的 SIID 5 就是数组第一个数字。你的型号如果已在 支持的音箱型号 列表里直接抄现成参数即可。指定要用的大模型编辑.env最小可用配置只有两行OPENAI_API_KEYsk-xxxxxxxxxxxx OPENAI_MODELgpt-4o-mini # 用其他兼容 OpenAI 格式的模型时取消下行注释并填写 # OPENAI_BASE_URLhttps://your-service/v1注意变量名保持OPENAI_*不变想换通义千问、DeepSeek 这类服务商时只改OPENAI_BASE_URL和 Key 的值就行。一条命令拉起服务docker run -d --env-file $(pwd)/.env \ -v $(pwd)/.migpt.js:/app/.migpt.js \ idootop/mi-gpt:latestWindows 终端下把$(pwd)换成配置的绝对路径。启动成功后用docker ps | grep mi-gpt确认容器在跑日志里出现服务已启动就齐活了。对着音箱验证效果验证按由浅入深来说小爱同学请问地球为什么是圆的——走请字开头的即时问答链路说小爱同学召唤傻妞——进入唤醒模式之后直接提问即可不用每句带小爱同学回答完等它说我说完了停顿一两秒再追问体验连续对话说小爱同学退出傻妞——回到普通小爱状态。四条都走得通接入就算完成。值得动手改的三个参数改唤醒词和退出词改哪里.migpt.js的speaker段。为什么默认词是傻妞换成自己喜欢的称呼家里人才好记退出词独立设置避免误触。怎么改speaker: { callAIKeywords: [请, 小贝], wakeUpKeywords: [召唤小贝, 打开小贝], exitKeywords: [退出小贝], },改完记得重启容器。把默认音色换掉改哪里.migpt.js的speaker.tts加.env的TTS_BASE_URL。为什么小米自带 TTS 遇到敏感词会拒播且音色单一接第三方服务如火山引擎实名后有多款免费音色听感更接近真人。怎么改speaker: { tts: custom, switchSpeakerKeywords: [把声音换成], }TTS_BASE_URLhttp://192.168.x.x:4321/xxxx/api注意地址要写局域网或公网 IPlocalhost音箱访问不到。配好后说小爱同学把声音换成灿灿即可切换音色详见 第三方 TTS 说明。让回答更快改哪里.migpt.js里回答前后的提示语。为什么默认让我先想想我说完了每轮都播体感拖沓。怎么改把onAIAsking和onAIReplied置为空数组再选响应快的模型如 gpt-4o-mini一来一回省下的等待最直观。三种进阶玩法给自己立一个人格。改.migpt.js里的bot、master简介和systemTemplate比如设定一个说话带点毒舌但句句在理的邻居姐姐AI 会用第一人称扮演连称呼都跟着人设走。做孩子的作业搭子。在系统 Prompt 里约束你是一位耐心的小学老师回答不超过三句话先给思路再给答案配合长短期记忆它记得住孩子昨天问错的那道应用题。换一颗更懂中文的大脑。不必只用 OpenAI通义千问、DeepSeek 等兼容 OpenAI 格式的服务改.env里三个值就切换豆包这类不兼容的接口前面垫一层 API 聚合网关转成 OpenAI 格式再接入即可。避坑手记现象启动时报70016登录验证失败。原因把手机号或邮箱填进了userId它只认小米 ID。解法登录小米账号官网进个人信息页抄那串数字。现象提示找不到设备xxx。原因did与米家中设备名不一致多为手打时的错别字。解法回米家设备名页面复制原文粘贴别凭记忆敲。现象服务器登录被异地风控拦下。原因部署环境的 IP 与平时登录地差异太大触发小米安全验证。解法在与服务器相同的网络下手动登录一次小米官网、完成验证等约一小时再试仍不行的话在本地跑通后把生成的.mi.json挂到容器的/app/.mi.json下。现象连续对话时说话没反应。原因提问时机不对——AI 正在回答、或音箱在放音乐时根本听不见你。解法等我说完了之后停一两秒再问正在播歌就先暂停实在没响应用小爱同学重新唤醒再说一次。延伸资料参数设置每个配置项的完整含义与默认值常见问题启动失败、连续对话等高频问题的官方答复支持的音箱型号各型号的指令参数对照表工作原理指令如何被截获与回传的链路说明MiGPT 更适合两类人手上有一台吃灰小爱音箱、想让它真正会说话的家庭用户以及想低成本验证大模型 语音硬件玩法的开发者。前者照前文走完主流程即可后者可以顺着 源码目录 从services/speaker/的指令收发读起。项目目前已停止维护功能以现有版本为准动手前留个心理预期就好。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考