如何把小爱音箱接入 ChatGPT 改造成 AI 语音助手MiGPT 5 步跑通全流程【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt晚上对音箱说一句小爱同学召唤傻妞它用接近真人的声音回答你还能接着聊、记得刚才说过什么——这就是 MiGPT 做的事把小爱音箱接入 ChatGPT、豆包等大模型不用刷机把手上的音箱变成你的 AI 语音助手。项目定位MiGPT 是一个跑在电脑或服务器上的开源服务它通过小米开放接口轮询小爱音箱的对话把消息转发给大模型再把 AI 的回复用音箱读出来。它适合手里有小爱音箱、想体验大模型语音交互但又不想动硬件的人。能做什么替你省掉什么适合谁AI 问答、角色扮演、流式回答买新硬件和刷固件的折腾音箱原样使用想给现有音箱加 AI 对话能力的用户连续对话与长短期记忆每句话重复唤醒词、重复交代背景需要多轮交互的家庭用户自定义提示语、第三方 TTS 音色默认的机械音色和固定话术在意声音体验、想调人设的用户注意项目目前已停止维护功能以仓库当前版本为准。动手前准备按下面 5 项自查缺一项先补齐再动手准备项说明检查方式小爱音箱型号需在支持列表内小度、天猫精灵等不支持米家 App 设备详情页查看型号对照 docs/compatibility.md小米账号需要小米 ID 和账号密码用于连接设备账号「个人信息-小米 ID」页能看到一串数字 ID大模型 API Key任意 OpenAI 兼容服务OpenAI、通义千问、DeepSeek 等用密钥调一次接口能正常返回回答运行环境Docker或 Node 20 跑源码docker -v能输出版本号网络用海外模型时需要代理在运行 MiGPT 的机器上能访问模型 API主流程5 步部署 MiGPT第 1 步克隆代码并准备两个配置文件目标拿到项目代码并生成待填写的 .env模型配置和 .migpt.js音箱配置。git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env cp .migpt.example.js .migpt.js验证点✅ 执行ls后能看到 .env 和 .migpt.js这两个文件就是你唯一要改的地方。第 2 步填写大模型与小米账号信息目标让 MiGPT 知道调用哪个模型、如何连上你的音箱。.env 里填模型密钥用通义千问等国内模型时只改下面三项的值即可OPENAI_API_KEYsk-你的密钥 OPENAI_MODELgpt-4o-mini.migpt.js 的 speaker 部分填账号和设备speaker: { userId: 你的小米ID, password: 账号密码, did: 小爱音箱Pro, }验证点✅ did 与米家中显示的设备名逐字一致没有多余空格、大小写相同。⚠️ 注意小米 ID 不是手机号或邮箱请到小米账号「个人信息-小米 ID」页查看那串数字。第 3 步启动服务目标跑起 MiGPT 并让它连上音箱。新手推荐 Docker 方式docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest 提示Windows 终端不支持 $(pwd)请在命令里直接写 .env 和 .migpt.js 的绝对路径。想跑源码的话在代码目录依次执行pnpm install、pnpm build、pnpm dev。验证点✅ 控制台打印 MiGPT 横幅和「服务已启动」没有报错日志。第 4 步验证 AI 问答目标问出第一个问题确认唤醒-转发模型-读回回复整条链路打通。对着音箱说小爱同学请问地球为什么是圆的验证点✅ 音箱先播提示语让我先想想然后朗读大模型的回答控制台同步打印 AI 的回复文本。第 5 步体验连续对话目标进入 AI 模式追问时不用再喊小爱同学。说小爱同学召唤傻妞等欢迎语播完后再直接提问。验证点✅ 音箱播你好我是傻妞很高兴认识你回答完会说我说完了30 秒内不提问会自动退出 AI 模式。关键配置3 个新手最容易踩的参数完整参数见 docs/settings.md新手只需要先弄懂这 3 个参数作用新手建议值callAIKeywords消息以哪些词开头时才转发给 AI 回复保持默认[请, 你, 傻妞]ttsCommand / wakeUpCommand音箱朗读文字和唤醒的 MIoT 指令不同型号不同默认[5, 1]/[5, 3]适配多数型号不通再按型号查streamResponse连续对话开关依赖机型能查询播放状态先填false确认型号支持后再开不同型号的指令值不一样可以在 home.miot-spec.com 站点搜索音箱型号如 LX06点「规格」进入规格文档把 play-text、wake-up 的 AIID 组合填进配置跑通验证由简到难的 5 组测试指令基础指令小爱同学请介绍一下你自己预期先播提示语让我先想想再朗读 AI 自我介绍。基础指令小爱同学请问地球为什么是圆的预期得到大模型的完整回答而不是原小爱的固定回复。组合指令小爱同学你是xxx你xxx更换人设后再提问预期 AI 按新人设口吻回答。组合指令小爱同学召唤傻妞进入连续对话回答结束后直接追问预期无需再说小爱同学等我说完了出现即可提问。异常指令音箱正在放音乐时提问。预期 AI 不响应需要先暂停音乐AI 读个没完时说小爱同学请你闭嘴可以打断。常见问题MiGPT 启动报错与无反应排查QMiGPT 提示70016登录验证失败怎么解决小米 ID 填成了手机号或邮箱。userId 要求数字小米 ID到账号「个人信息-小米 ID」页复制后重新填写再重启服务。QMiGPT 提示找不到设备xxx怎么办did 与米家中的设备名不一致。打开米家 App 的小爱音箱主页核对设备名称注意空格和大小写例如小爱音箱Pro而非小爱音箱 Pro仍不一致时在 speaker 里打开debug和enableTrace从控制台输出的设备列表里取 miotDID 填入。Q音箱没出声但控制台能看到 AI 的回复ttsCommand 与你的型号不匹配。去 home.miot-spec.com 搜索音箱型号点「规格」找到 play-text 指令及参数修改 .migpt.js 里的 ttsCommand 后重启容器。Q提示LLM 响应异常 Connection error是什么原因网络访问不了模型服务。用 OpenAI 时在 .env 里加HTTP_PROXY或换成通义千问等国内模型变量名不变只改 OPENAI_BASE_URL 和 OPENAI_MODEL 的值。Q连续对话时小爱总是把句子读一半就停你的型号查不到播放状态需要关闭连续对话。对照 docs/compatibility.md 确认型号是否在支持列表不在就把 streamResponse 设为falseAI 会整句读完后再等你提问。延伸阅读兼容型号与指令对照表、第三方 TTS 接入教程。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考