把小爱音箱接进大模型完整避坑指南与 4 层链路拆解【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt想让家里吃灰的小爱音箱真正听懂人话MiGPT 干的事就一句话把小爱音箱接入 ChatGPT 和豆包这类大模型让它从只会放歌的闹钟变成能连续追问、记得上下文的专属语音助手。全文按配置、部署、设备桥接、模型接入四层链路拆解读完就能跑起来。改造前后差在哪先用你每天真实会遇到的场景对比原生状态和接入 MiGPT 之后的差别你实际会干的活原生小爱MiGPT 改造后问复杂问题简单问答还行绕一点就糊弄复杂推理、写文案、讲原理都能接住连续追问每句都得重新喊小爱同学进入唤醒模式后连续对话等提示语说完接着问换个说话风格语音包基本固定接第三方 TTS豆包同款音色语音一句话换记得刚才说了啥一问一答聊完即忘携带长短期记忆越聊越贴上下文自定义人设出厂设定改人设和系统 Prompt角色随你捏动手前门槛速查表类别需要满足什么必须/可选怎么验证硬件小爱音箱推荐小爱音箱 Pro完美运行小度、天猫精灵不在适配范围必须型号和指令参数对照 compatibility 文档软件Docker或 Node 20 环境必须docker -v/node -v账号小米账号要小米 ID 一个大模型 API 密钥必须小米 ID 在 account.xiaomi.com 个人信息页查看不是手机号网络能直连所选模型 API国内直连 OpenAI 需代理或改用国产模型必须服务器环境执行curl https://api.openai.com看是否通配置层人设和设备参数都写在哪这一层定义AI 是谁、说话给哪台设备涉及两份文件.migpt.js管人设和设备参数.env管 API 密钥。// .migpt.js从 .migpt.example.js 复制后修改 export default { bot: { name: 傻妞, // AI 角色名 profile: 性格乖巧可爱喜欢搞怪。 // 人设 }, speaker: { userId: 123456789, // 小米 ID不是手机号或邮箱 password: 账号密码, did: 小爱音箱Pro, // 米家 App 里的设备名一字不差 ttsCommand: [5, 1], // 朗读指令 wakeUpCommand: [5, 3], // 唤醒指令 }, };# .env从 .env.example 复制后修改 OPENAI_API_KEY你的密钥 OPENAI_MODELgpt-4o⚠️ 两个高频坑did直接复制米家 App 显示的设备名原文别自己打错别字、多余空格、大小写不一致都会导致找不到设备小米 ID 去官网个人信息页查填手机号会直接报登录验证失败。部署层Docker 一行命令源码三步这一层只是把服务跑起来不碰业务逻辑。# 方式一Docker docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest# 方式二源码Node 20 pnpm install # 安装依赖 pnpm db:gen # 初始化数据库 pnpm dev # 启动看到服务已启动日志就算跑通。⚠️ Windows 终端里$(pwd)不生效必须写成配置文件绝对路径比如D:/hello/mi-gpt/.env数据库路径里别出现中文或空格否则会初始化失败。设备桥接层它到底怎么指挥你的音箱MiGPT 并不刷机而是轮询小米云端的对话列表发现你的新消息 → 调大模型生成回答 → 合成人声音频 → 通过 MIoT 指令让音箱播放。整套控制全靠 TTS、唤醒、播放状态查询这三类指令而指令编号因型号而异这是整个改造里最容易翻车的一环。按你的型号去 MIoT 规格库搜设备如小爱音箱 Pro 是 LX06找到 play-text 和 wake-up 两个方法对应的编号组合speaker: { ttsCommand: [5, 1], // 朗读 wakeUpCommand: [5, 3], // 唤醒 playingCommand: [3, 1, 1], // 查询播放状态默认不用配 };⚠️ 三类典型故障按症状对号有反应但不播回答 →ttsCommand填错回规格页核对回答说一半戛然而止 → 该型号查不到播放状态配playingCommand还不行就关闭streamResponse代价是连续对话失效报找不到设备 → 设备名和米家不一致打开debug与enableTrace看日志里的miotDID填进去。跑通后有三种玩法小爱同学请 xxx直接调用 AI 回答小爱同学你 xxx以对话口吻提问小爱同学召唤傻妞进入唤醒模式连续对话约 30 秒没动静会自动退出。模型接入层换个模型只改环境变量MiGPT 走的是 OpenAI 兼容协议所以接任何模型都只动.env代码一行不碰。# 国内模型示例通义千问 OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1 OPENAI_MODELqwen-turbo OPENAI_API_KEY你的密钥豆包这类不兼容 OpenAI 格式的模型先用 API 聚合服务转一层再填OPENAI_BASE_URL。⚠️ 报 401 是密钥问题报模型不存在通常是新账号没绑卡用不了 gpt-4 系列换gpt-3.5-turbo就通国内直连 OpenAI 超时配HTTP_PROXY或干脆换国产模型。进阶玩法三处小改动效果立竿见影如果你想给 AI 换个灵魂改写.migpt.js里的bot.profile并自定义systemTemplate。模板里{{botName}}、{{masterName}}、{{messages}}等变量会在运行时自动替换完整变量表见 prompt 文档。说一句小爱同学你是 xxx你 xxx还能临时换人设。如果你想换音色在.env里配置TTS_BASE_URL指向第三方 TTS 服务再把tts从xiaoai改成custom之后对着音箱说小爱同学把声音换成 xxx即可即时切换。如果你想让它回得快一点默认参数偏保守可以这样调speaker: { onAIAsking: [], // 去掉让我先想想提示语 onAIReplied: [], // 去掉我说完了提示语 checkInterval: 500, // 播放状态检测间隔调小 };配合响应更快的模型等待感会明显下降。排障手册症状对号入座症状最可能原因一条修复动作启动报70016 登录验证失败小米 ID 填成了手机号或邮箱改成 account.xiaomi.com 个人信息页里的数字 ID触发异地登录保护账号在新网络环境登录同网络下走一遍小米官网安全验证约 1 小时后重试找不到设备xxx设备名与米家不一致复制米家设备名原文仍不行开 debug 日志取 miotDID 填入didERR_MODULE_NOT_FOUND配置文件没挂进容器确认容器内/app/.migpt.js存在Windows 下改绝对路径有响应但听不到 AI 回答TTS 指令与型号不符查 MIoT 规格页 play-text 编号修正ttsCommand回答说一半就停播放状态查不到配playingCommand或关闭streamResponseLLM 响应异常 404/401模型无权限或密钥失效换gpt-3.5-turbo或重新验证OPENAI_API_KEY回答慢得像在等快递提示语和轮询间隔偏保守checkInterval调到 500清空提示语换快模型说唤醒词音箱开始放歌唤醒词被当歌名把wakeUpKeywords换成打开之类不易撞歌名的词落地场景装好后可以怎么玩给小孩当作业辅导员人设调成耐心的老师作业问题直接问。给老人做翻译与陪伴自动把方言口语转成普通话摘要。睡前故事机每天固定讲一个不重样的三分钟故事。现在就能做的 5 件事把小爱音箱的型号、米家设备名、小米 ID 抄进备忘录克隆仓库git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt并进入目录复制.migpt.example.js和.env.example为正式配置文件填好 API 密钥和设备参数跑通 Docker 启动命令对音箱说小爱同学召唤傻妞验证第一句对话卡在哪一层就回哪一层查参数多半两分钟就能定位。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考