ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

小爱音箱接入大模型全攻略:零基础MiGPT配置教程,5分钟告别“人工智障“

小爱音箱接入大模型全攻略:零基础MiGPT配置教程,5分钟告别“人工智障“ 小爱音箱接入大模型全攻略零基础MiGPT配置教程5分钟告别人工智障【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt晚上九点你窝在沙发里随口问了一句小爱同学黑洞里面到底是什么音箱沉默了三秒然后答非所问地播起了天气预报。这个画面是不是特别熟悉问题不在音箱硬件而在它脑子里那套固定的应答话术。而 MiGPT正是把小爱音箱接入 ChatGPT、豆包等大模型的开源方案——它能让你的音箱学会语义理解、记住上下文、甚至拥有专属人设从人工智障变成真正懂你的语音助手。这份零基础小爱音箱接入大模型配置教程不绕弯子5 分钟就能让你家的音箱开口说人话。为什么越来越多人给音箱换脑先别急着动手我们来看看改造前后到底差在哪里。就拿帮我推荐一部适合周末看的电影这句话举例对比维度改造前的小爱音箱MiGPT 接入大模型后理解方式关键词匹配只认固定指令语义理解能听懂开放式提问知识范围内置词库问深一点就哑火大模型知识天文地理都能聊回答风格千篇一律的官方腔可定制人设每句话都有性格记忆能力说完就忘长短期记忆越聊越懂你响应方式要么答非所问要么沉默流式回复配合提示语衔接自然一句话总结改造前它是个复读机改造后它是你的家庭 AI 管家。而这一切不需要换硬件、不需要刷机只需要一个开源项目 MiGPT 就能完成。5 分钟跑通先让小爱音箱开口说人话与其看一堆理论不如先让效果说话。按下述流程走一遍最快 5 分钟就能在终端里看到 AI 替你的音箱回答问题。动手前先确认三件事一台小爱音箱推荐小爱音箱 Pro兼容性最好一台能运行 Node.js 16 或 Docker 的电脑一个小米账号注意是小米 ID不是手机号或邮箱。先拿到项目代码。打开终端克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install # 没有 pnpm 就用 npm install接着生成配置文件。项目自带两份模板直接复制改名即可cp .env.example .env cp .migpt.example.js .migpt.js最后填上最小的三行配置。打开.migpt.js找到speaker字段把这三项改成你自己的speaker: { userId: 你的小米ID, // 小米账号里的数字ID不是手机号 password: 你的密码, did: 小爱音箱Pro, // 音箱在米家APP里显示的名称 },这段配置的作用是让 MiGPT 以你的小米身份登录并在你的设备列表里定位到那台音箱。然后执行pnpm start看到终端里打出服务已启动和你好我是豆包很高兴为你服务这样的日志就说明你的音箱已经被大模型接管了 MiGPT 服务启动成功的终端界面看到服务已启动就说明配置生效了现在对着音箱说一句小爱同学请问地球为什么是圆的——恭喜你家的人工智障正式毕业了。核心配置逐项拆解每个参数到底在干嘛跑通只是开始想让它稳定又好玩下面这几个配置值得你逐个看懂。账号三件套userId、password、diduserId是最容易填错的一项。它既不是手机号也不是邮箱而是小米账号里的数字 ID。did是音箱在米家 APP 里的设备名称必须一字不差小爱音箱 Pro和小爱音箱Pro都可能让程序报找不到设备。拿不准你的型号支不支持时可以先去 miot-spec 网站上搜索音箱型号、确认规格文档在 miot-spec 上搜索音箱型号确认设备兼容性与规格参数指令参数ttsCommand 与 wakeUpCommand每个型号的小爱音箱语音合成和唤醒的底层指令可能不一样。默认值[5, 1]和[5, 3]覆盖了绝大多数型号但如果出现控制台有 AI 回复、音箱却不说话的情况多半就是这里对不上号音箱指令映射表ttsCommand[5,1] 负责文字转语音wakeUpCommand[5,3] 负责唤醒人设与回复风格bot、master、systemTemplateMiGPT 最大的乐趣在于捏人设。在.migpt.js里你可以给音箱定义一个角色bot: { name: 傻妞, profile: 性别女性格乖巧可爱喜欢搞怪爱吃醋, }, systemTemplate: 你是一个名叫{{bot.name}}的AI助手请用{{bot.profile}}的风格与主人对话回答保持精简。改完重启服务你的音箱就不再是那个官方腔的小爱而是有名字、有性格、会跟主人拌嘴的专属伙伴。交互关键词让 AI 只在你想让它出场时出场speaker: { callAIKeywords: [请, 你, 傻妞], // 以这些词开头才调用大模型 wakeUpKeywords: [打开, 进入, 召唤], // 触发连续对话模式 exitKeywords: [退出, 关闭], // 退出连续对话 onEnterAI: [你好我是傻妞很高兴认识你], }简单来说callAIKeywords决定这句话要不要交给大模型wakeUpKeywords则让你一键进入免唤醒的连续对话状态。进阶玩法连续对话、换音色与提速三连连续对话不用每句话都喊小爱同学进入唤醒模式后比如对小爱说小爱同学召唤傻妞接下来你只需要直接提问不用每句都以小爱同学开头默认 30 秒内没有新指令会自动退出。如果你的音箱回答总是说一半就停多半是播放状态查询指令不匹配按命令映射表查一下你的playingCommand并填进配置即可。换音色解锁豆包同款 TTS听腻了自带声音MiGPT 支持接入任意第三方 TTS 服务。把tts设为custom在.env里配好TTS_BASE_URL再设置一组切换关键词就能实现换成男生声音换成女生声音这样的语音切换。完整接法见 docs/tts.md。提速让回复快人一步默认参数偏保守想要秒回体验可以关掉回答前后的提示语、把播放状态检测间隔调到 500 毫秒并优先选用 gpt-4o 这类响应快的模型speaker: { tts: xiaoai, // 使用小爱自带的 TTS 引擎 onAIAsking: [], // 去掉让我想想之类的开场白 onAIReplied: [], // 去掉我说完了之类的结束语 checkInterval: 500, // 降低回复之间的停顿感 }最容易踩的 5 个坑附救场方案这些坑都是真实用户反复踩过的提前排雷能帮你省下大量时间 报错70016登录验证失败十有八九是把小米 ID 填成了手机号或邮箱。去小米账号的个人信息页面复制你的数字 ID注意那不是手机号。报错找不到设备xxxdid和米家里的设备名对不上。直接打开米家 APP复制小爱音箱主页的设备名称别写错别字也别画蛇添足加空格。控制台有回复音箱却不出声ttsCommand与你的型号不匹配。按上文指令对照图去 miot-spec 查询你设备的真实指令改完重启即可。回答总说一半就停播放状态检测失败尝试配置playingCommand。如果你的型号不支持通过开放接口查询播放状态就在配置里把streamResponse关掉保底。提示 LLM 响应异常401/404要么是 API Key 失效要么是网络不通。国内网络环境下记得把OPENAI_BASE_URL换成国产模型服务商的兼容地址比如通义千问的OPENAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1同时把OPENAI_MODEL改成qwen-turbo。更多报错的对症下药清单可以翻翻 docs/faq.md基本都能对号入座。下一步从跑通到真香现在你已经完成了从只会播报天气的复读机到懂你的家庭 AI 管家的第一步。剩下的乐趣全在折腾调一个毒舌人设、接入通义千问或 DeepSeek、甚至部署本地大模型都只是改改配置的事。想深入研究的话这几份资料值得收藏完整参数说明docs/settings.md常见问题自查docs/faq.md第三方 TTS 接入docs/tts.md运行原理解析docs/how-it-works.md本地开发指南docs/development.md动手之前多说一句别把改造想得太复杂真正必填的其实只有三个字段。跑通一次之后你会忍不住想把家里每一台小爱音箱都装上。去试试吧你的第一句小爱同学请介绍一下你自己值得被一个更聪明的回答接住。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进