小爱音箱接入ChatGPT:MiGPT一条命令启动上手指南 小爱音箱接入ChatGPTMiGPT一条命令启动上手指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt用前问小爱“解释一下量子纠缠”它只会回“不太明白你的意思”用后你说“小爱同学量子纠缠是什么”它用大模型流畅作答还能连续追问。MiGPT 把 ChatGPT、豆包等大模型接入小米小爱音箱把它改造成能连续对话的语音助手不用刷机靠小米开放接口在后台跑一个服务即可。动手前先查清开始前有 4 样东西要备齐按表格逐项确认中途就不会卡壳要备齐什么为什么需要怎么确认小米系小爱音箱MiGPT 只通过小米 MIoT 云端接口控制小爱音箱小度、天猫精灵、HomePod 均不支持打开米家 App 确认音箱在线并在 docs/compatibility.md 里核对型号Pro 系支持最完整小米账号和密码服务要替你账号登录才能下发音箱指令userId必须是纯数字“小米 ID”登录小米官网在“个人信息”页能看到你的小米 ID不是手机号、不是邮箱一个大模型 API KeyMiGPT 自身不产生回答所有回复都来自大模型持有任意 OpenAI 兼容接口的密钥即可OpenAI、通义千问、Moonshot、DeepSeek 等运行环境二选一Docker 或 Node.js 两种部署方式任选Docker 用户执行docker -vNode 用户执行node -v建议 20官方镜像基于 Node 20.14如果你查自己的型号去 MIoT 规格文档站按型号搜索能看到 ttsCommand、wakeUpCommand 等指令参数的基本就能用型号和现成参数直接查 docs/compatibility.md⚠️ 两个配置文件.env和.migpt.js会写明文存放你的小米账号密码和大模型密钥请放在自己信任的机器上不要外传、不要提交到任何仓库。跑通第一次Docker 路线只有 3 步不用装任何开发环境。第 1 步拉源码从模板生成两个配置文件。git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .env.example .env # 大模型相关配置 cp .migpt.example.js .migpt.js # 音箱账号与角色配置完成信号目录里多出.env和.migpt.js两个新文件。第 2 步只填必填项。.env里必填 3 项变量填什么OPENAI_API_KEY你的大模型密钥OPENAI_MODEL模型名如gpt-4o-miniOPENAI_BASE_URL非 OpenAI 官方接口时填写一般以/v1结尾.migpt.js里必填 3 项speaker.userId小米 ID、speaker.password密码、speaker.did米家里的设备名称逐个字符对照注意空格、大小写“音响”这类错别字都会导致找不到设备。第 3 步一条命令启动。docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest完成信号执行docker logs -f看到 “Speaker ✅ 服务已启动...” 后对音箱说“小爱同学召唤傻妞”默认角色名叫傻妞可改它会先提示“让我先想想”再开口自我介绍。注意两点Windows 终端下$(pwd)不生效要换成配置文件绝对路径如D:/hello/mi-gpt/.env如果你是 Node 开发者也可以npm install mi-gpt后用代码方式初始化启动参数说明看 docs/development.md。接下来怎么玩陪孩子讲题直接说“小爱同学请给我讲讲地球为什么是圆的”。“请”在默认触发词callAIKeywords默认[请, 你, 傻妞]里AI 会接管回答。想换触发词往callAIKeywords数组里加改完重启容器生效。完成信号它先播报onAIAsking里的提示语默认“让我先想想”随后开始作答而不是像原厂那样说“我不太明白”。给她换一个人设.migpt.js里bot.name和bot.profile定义角色也可以语音临时改说“小爱同学你是一名小学老师你喜欢用生活例子讲题”“你是 xxx你 xxx”句式。完成信号问“你叫什么名字”它以新人设应答。连续追问不喊唤醒词说“小爱同学召唤傻妞”等它说完欢迎语之后每轮直接提问不用再喊“小爱同学”用“小爱同学再见”退出。前提是streamResponse设为true且你的型号支持播放状态查询兼容表“完美运行”名单Pro 最稳。如果它回答总是说到一半戛然而止多半是型号缺playingCommand按下图方式在 MIoT 规格文档里查到对应值填进.migpt.js完成信号进入唤醒模式后不喊“小爱同学”直接问“1加1等于几”它能正常回答。出问题怎么办高频问题都在这张表里表里没有的先搜 docs/faq.md现象最可能原因一条验证命令日志“70016登录验证失败”userId填了手机号/邮箱应为纯数字小米 ID打开.migpt.js确认userId是纯数字“找不到设备xxx”did与米家中设备名不一致空格/大小写/错别字米家 → 音箱主页 → 更多 → 设备名称逐字比对“ERR_MODULE_NOT_FOUND”.migpt.js没挂载或内容有语法错误docker exec -it 容器ID ls /app/.migpt.js确认文件存在控制台有 AI 回复音箱不出声ttsCommand与当前型号不匹配按 MIoT 规格查本型号 ttsCommand 填入回答总是说到一半中断播放状态查不到playingCommand未配置在兼容表中查本型号有无playingCommand值“LLM 响应异常 Connection error”网络到不了模型接口curl -I https://api.openai.com/v1看能否连通提示触发异地登录保护小米账号安全验证未通过在与服务相同网络下手动登录一次小米账号ttsCommand、wakeUpCommand、playingCommand的取值规律在 MIoT 规格文档中按型号搜出规格SIID第一层加 AIID/PIID第二层拼成数组例如 SIID 5、AIID 1 即[5, 1]收尾⚠️ 仓库 README 已声明本项目停止维护接入新机型或升级前请先看 docs/changelog.md 确认当前版本与已知限制。跑通之后剩下的是调优全部参数在 docs/settings.md想换豆包同款音色看 docs/tts.md。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考