3步把小爱音箱接入ChatGPT：MiGPT语音助手部署完整指南

3步把小爱音箱接入ChatGPTMiGPT语音助手部署完整指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt小爱音箱只会放歌和查天气一问三不知MiGPT 能将小爱音箱接入 ChatGPT 等主流大模型改造成你的专属 AI 语音助手支持角色扮演、流式响应和长短期记忆。本文带你完成部署前的准备、两种安装方案和首次运行自检照做即可让家里的音箱开口答问。一、部署前准备一张清单备齐前置条件在动手之前先确认你手头的硬件 账号 密钥都齐了类别要求说明音箱设备小爱音箱 Pro推荐或其他兼容型号查看下方兼容性表格完整列表服务器一台能跑 Docker 或 Node.js 16 的机器无需与音箱同局域网云端接口即可控制小米账号小米 ID不是手机号或邮箱 密码在米家 App「我的 - 个人信息 - 小米 ID」中查看音箱名称米家中设置的设备名称米家 App → 音箱主页 → 更多 → 设备名称注意空格和大小写大模型密钥OpenAI API Key或其他兼容 OpenAI 接口的模型如通义千问、DeepSeek、Moonshot 均可常见小爱音箱兼容性与核心指令参数摘自 docs/compatibility.md设备名称型号ttsCommandwakeUpCommand连续对话小爱音箱 Pro推荐LX06[5, 1][5, 3]支持小米 AI 音箱第二代L15A[7, 3][7, 1]支持小爱智能家庭屏 10X10A[7, 3][7, 1]支持小爱音箱 Play 增强版L05C[5, 3][5, 1]不支持需关闭 streamResponse小爱触屏音箱LX04[5, 1][5, 2]不支持需关闭 streamResponse提示小米小爱音箱 HDSM4目前不支持小度、天猫精灵等第三方设备不在支持范围内。二、安装部署两条路径任选其一路径 ADocker 快速部署推荐新手容器镜像内置运行环境不用自己装 Node 依赖一条命令即可启动。# 1. 获取项目源码 git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt # 2. 复制两份配置模板.migpt.js 是主配置.env 是环境变量 cp .migpt.example.js .migpt.js cp .env.example .env配置文件改好之后下一节详细讲启动容器docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest--env-file把大模型密钥等环境变量注入容器-v把你本地的.migpt.js挂载到容器/app/.migpt.js改配置时只需改本地文件。注意Windows 终端下$(pwd)无法解析请把两个路径写成绝对路径例如-v D:/hello/mi-gpt/.migpt.js:/app/.migpt.js。路径 B源码部署适合二次开发如果你要改 Prompt、加功能建议走源码路线。环境要求Node.js 16默认 Node 20 pnpm。git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install # 安装依赖postinstall 会自动初始化本地数据库 pnpm build # 构建 dist 产物 pnpm dev # 开发模式启动自动加载 .envpnpm dev会以开发模式读取.env与.migpt.js并启动服务想长期稳定运行改用pnpm start运行app.js项目路径中不要包含中文或空格否则数据库初始化会失败。更多本地调试细节见 docs/development.md。三、核心配置两个文件逐条讲透所有必须修改的配置集中在两个文件.migpt.js设备与行为和.env大模型。1..migpt.js告诉 MiGPT 登录谁、控制哪台音箱export default { // 小爱音箱扮演的角色AI 的人设可随意改成你想要的性格 bot: { name: 傻妞, profile: 性别女性格乖巧可爱喜欢搞怪爱吃醋。, }, // 你主人的人设 master: { name: 你的称呼, profile: 性别男善良正直。, }, speaker: { // ⬇️ 必须修改的核心三项 userId: 你的小米ID, // 不是手机号/邮箱米家「个人信息-小米ID」查看 password: 你的小米密码, did: 小爱音箱Pro, // 与米家中设备名称完全一致注意空格和大小写 // ⬇️ 按你的音箱型号填写 MIoT 指令查 docs/compatibility.md ttsCommand: [5, 1], // TTS 播报指令AI 回答靠它出声 wakeUpCommand: [5, 3], // 唤醒指令AI 唤醒设备持续收听 // 触发规则消息以这些词开头时才调用 AI 回答 callAIKeywords: [请, 你, 傻妞], // 进入/退出 AI 连续对话模式的关键词 wakeUpKeywords: [打开, 进入, 召唤], exitKeywords: [关闭, 退出, 再见], // 连续对话实验性功能你的型号支持则设 true否则保持 false streamResponse: false, }, };关键参数说明userId填错是最常见的启动失败原因。小米 ID 是一串数字务必去米家「个人信息」里复制别用手机号。did建议直接从米家复制设备名称。小爱音响、小爱音箱 Pro带空格、小爱音箱pro小写都是错误示范。ttsCommand / wakeUpCommand不同型号指令不同照抄 兼容列表 中对应型号的值即可未列出的型号可在社区 issue 中搜索分享记录。2..env配置大模型服务OPENAI_MODELgpt-4o-mini # 使用的模型 OPENAI_API_KEYsk-你的API密钥 # 从模型服务商处获取 # 使用 OpenAI 官方接口时无需下面这行 # 接入通义千问/DeepSeek 等兼容服务时填写对应接口地址一般以 /v1 结尾 # OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1变量名固定以OPENAI_开头只是值换成你服务商的地址和密钥即可接入任意兼容 OpenAI SDK 的模型豆包等不兼容 OpenAI 接口的模型需借助 API 聚合服务转换后接入详见 docs/faq.md 相关说明。四、首次运行与功能自检启动后保持终端窗口开着对着音箱依次做两组测试。基础可用必测对音箱说小爱同学请问地球为什么是圆的预期AI 先说出提示语让我先想想随后用语音完整回答问题最后说我说完了。同时看终端应滚动打印出 AI 的文本回复若只听到原小爱应答而终端没有新日志说明消息未被拦截检查callAIKeywords配置。进阶能力按型号支持情况测试对音箱说小爱同学召唤傻妞对应wakeUpKeywords。进入唤醒模式后无需再喊小爱同学直接连续追问即可无响应超过 30 秒自动退出。验证人设说小爱同学你现在是英语老师教我几个日常用语AI 应切换成老师口吻。提示提问时机有讲究等 AI 说我说完了停顿 1~2 秒再追问若小爱正在放音乐先让她暂停。五、排障速查最高频 4 类问题问题现象排查步骤启动报70016登录验证失败1. 确认 userId 是小米 ID 而非手机号2. 检查密码是否含特殊字符转义问题3. 若触发异地登录保护先在服务器同网络下登录小米官网通过安全验证启动报找不到设备xxx1. 检查 did 是否与米家设备名称一字不差空格/大小写/错别字2. 名称仍不行时开启enableTrace: true查看设备日志中的miotDID改用数字 ID音箱有反应但 AI 不回答1. 提问必须小爱同学请/你/傻妞…开头直接说请问 xxx无效2. 终端看是否打印 AI 回复有打印不出声则按型号核对ttsCommandLLM 响应异常401/404/Connection error1. 401 → API Key 无效或未生效2. 404 →OPENAI_BASE_URL或模型名拼写错误3. 网络不通 → 配置代理或改换国内大模型服务商更多问答见 docs/faq.md。六、进阶玩法与体验优化换音色接入第三方 TTS 服务如本地 ChatTTS在.env配置TTS_BASE_URL后说把声音换成 xxx即可切换音色教程见 docs/tts.md。调人设改.migpt.js里的bot.profile就能重塑性格运行中也可以直接说小爱同学你是 xxx你 xxx临时换角色。提速把onAIAsking/onAIReplied设为空数组去掉提示语连续对话时调小checkInterval最低 500ms回答之间的停顿感会明显降低。结语到这里你的小爱音箱已经接上 ChatGPT从人工智障升级成随叫随到的 AI 语音助手。MiGPT 还支持角色扮演、长短期记忆、流式响应等能力后续版本还会向智能家居 Agent 方向演进——不妨现在就对它喊一句小爱同学召唤傻妞或者去仓库看看 docs/how-it-works.md 了解它的实现原理。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考