小爱音箱接入 ChatGPT 和豆包怎么做MiGPT 新手完整指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个把家里的小爱音箱接入 ChatGPT、豆包等大模型的开源项目不刷机、不拆硬件改好两个配置文件再跑一条命令音箱就能变成会记忆、会角色扮演的专属语音助手。这篇文章带你从零走到音箱开口回话顺带把新手最容易卡住的坑提前讲清楚。改造后你会得到什么改造前音箱依赖内置问答库库内问题有答案库外问题就卡壳每次对话互不相干语气也永远是官方腔。接入 MiGPT 之后体验差异主要体现在这几点体验维度改造前接入 MiGPT 后问答内置问答库超出范围就卡壳大模型自由对话复杂问题也能答交互每次都要唤醒一问一答可进唤醒模式连续追问性格固定助手腔可设定姓名与人设音色官方默认音可接第三方 TTS 换声音原理上不难理解MiGPT 跑在你的电脑或服务器上通过小米云接口监听音箱的对话再把 AI 的回复用 TTS 指令播回音箱。详见 工作原理。不用深究细节只要记住一点服务不需要和音箱在同一局域网任意能常驻开机的设备都能跑。动手前确认型号并拿到项目先确认你的音箱在支持范围内大部分小爱音箱型号都能跑小爱音箱 Pro 最顺滑且每个型号的指令参数不同提前查好型号能少踩坑完整列表见 兼容型号。小度、天猫精灵、HomePod 不在支持范围内。把代码拉到本地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管的是“用哪个大模型”。.migpt.js里必填的核心字段长这样speaker: { userId: 你的小米ID, // 不是手机号或邮箱 password: 你的密码, did: 小爱音箱Pro, // 与米家名称完全一致 },三个容易翻车的点userId是小米 ID不是手机号或邮箱在账号个人信息页的「小米 ID」处查看。启动失败大多栽在这里。did是米家中的设备名空格、大小写、错别字都会导致“找不到设备”建议从米家直接复制粘贴。AI 的名字和人设写在bot.name与bot.profile里示例文件默认是“傻妞”。全部参数说明见 参数设置。.env起步只需两行OPENAI_API_KEYsk-xxxxxxxx OPENAI_MODELgpt-4o-mini一条命令跑起来新手推荐 Docker这条命令会把上面两份配置挂载进容器docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latestWindows 终端不能用$(pwd)要换成D:/hello/mi-gpt这类绝对路径。如果你习惯源码方式先安装依赖npm install mi-gpt然后按仓库内示例调用MiGPT.create初始化。注意 Node 模式下不会自动读取.env配置需要手动传入。控制台出现✅ 服务已启动...就成了。三种口令“召唤”它启动后用这三句话和音箱打交道小爱同学请 xxx——单次问答比如“小爱同学请说说地球为什么是圆的”小爱同学你 xxx——和 AI 闲聊比如“小爱同学你喜欢我吗”小爱同学召唤 xxx——进入唤醒模式之后可以连续追问说“退出”类口令离场两个要点必须先喊“小爱同学”唤醒直接对音箱说“请 xxx”它是听不见的。唤醒模式依赖播放状态查询部分型号不支持连续对话见 兼容型号 表格你的型号在“正常运行”列表里的话把配置中streamResponse设为false更稳妥。️ 没声音查设备指令控制台明明打印了 AI 回复音箱却不出声或者话说到一半戛然而止多半是两组数字没配对ttsCommand让音箱播放文本和wakeUpCommand唤醒音箱。小爱音箱 Pro 分别是[5, 1]和[5, 3]其他型号各不相同。查法在 MIoT 开放平台miot-spec搜音箱型号比如LX06点开「规格」规格页里play-text方法对应ttsCommandwake-up方法对应wakeUpCommand取值就是 SIID 加 AIID 两个数字如果回复总被截断而你的型号有playing-state属性对应[3, 1, 1]可以再把playingCommand配上让 MiGPT 正确判断播放状态 接国产大模型与换音色.env完全兼容 OpenAI 接口规范换OPENAI_BASE_URL、模型名和密钥就能切换服务商。以通义千问为例OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1 OPENAI_MODELqwen-turbo OPENAI_API_KEY你的千问密钥豆包、MoonshotKimi、DeepSeek 同理若某家模型不提供 OpenAI 兼容接口可先用 API 聚合工具转一层。国内网络访问与代理问题常见问题 里有详细处理办法。不习惯官方音色的话可以部署一个第三方 TTS 服务之后说“小爱同学把声音换成 xxx”就能切换音色配置步骤见 使用第三方 TTS。 常见坑与修复错误信息基本都会打在启动日志里对照着看70016登录验证失败——账号密码有误或userId填成了手机号回去核对小米 ID。触发异地登录保护——在跑 MiGPT 的同一网络下登录小米官网账号手动通过安全验证等约 1 小时再启动。“找不到设备”——did和米家名称不一致直接复制或在配置里开debug: true和enableTrace: true从日志的设备列表里拿miotDID填进去。LLM 响应异常 Connection error——国内网络到不了 OpenAI配代理或改用国产大模型。回复偏慢——把checkInterval调小到 500checkTTSStatusAfter酌情调大或调小并清空onAIAsking这类过渡提示语整体节奏会顺不少。更多场景见 常见问题。 两个日常玩法晚间作业搭子在bot.profile里把 AI 设定成耐心的“家教”孩子卡壳时说“小爱同学请给我讲一下这道题”音箱会把讲解读出来比盯着手机屏幕省心。家庭娱乐伙伴晚上用“召唤傻妞”进入唤醒模式让它讲故事、闲聊、推荐歌单连续对话模式下可以直接追问不用每句都重新唤醒。 现在开始最短路径是确认型号支持 → 复制两份模板填好小米账号和密钥 → Docker 一条命令启动 → 喊一句“小爱同学请 xxx” 听它回答。卡住时先翻 常见问题多数报错那里都有答案。一句温和的提醒本项目已停止维护功能稳定但不会再有新修复建议定期备份.migpt.js、.env和数据库文件环境折腾坏了也能随时恢复。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
