小爱音箱接入 ChatGPT 大模型：MiGPT 部署与使用指南
小爱音箱接入 ChatGPT 大模型MiGPT 部署与使用指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 是一个开源项目把小爱音箱接入 ChatGPT、豆包等大语言模型让音箱用大模型的能力回答问题、连续对话。适合想在家庭局域网里跑服务、不想刷机的小爱音箱用户。 MiGPT 能帮你做什么一句话定位MiGPT 通过小米 IoT 开放接口轮询音箱对话把语音转成 AI 问答再让音箱朗读回复全程不需要对音箱做任何硬件改动。AI 问答接入大模型后复杂问题、知识类提问由大模型直接作答角色定制可给助手设定姓名、性格、说话风格打造专属人设流式响应回复边生成边朗读减少干等的等待感长短期记忆基于本地数据库记录上下文支持多轮对话衔接音色更换可接入第三方 TTS 服务换成更接近真人的音色 动手前先确认这三件事设备型号大部分小爱音箱可用小爱音箱 Pro 运行最完整。其他型号先查 docs/compatibility.md 确认指令参数和是否支持连续对话小度、天猫精灵等品牌不在支持范围内。运行环境一台能长期开机的电脑或服务器4GB 内存以上装好 Docker 或 Node.js 20 即可。账号准备一个小米账号注意要小米 ID在账号个人信息的小米 ID一栏查看不是手机号或邮箱和对应密码再准备一个大模型 API Key如 OpenAI、通义千问等。 三步完成部署第 1 步获取项目。git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt第 2 步建立两个配置文件。项目根目录已有两个示例文件复制后改名再填写cp .migpt.example.js .migpt.js cp .env.example .env.migpt.js的关键字段字段含义bot.name/bot.profileAI 的名字和人设如性别女性格乖巧可爱speaker.userId小米 ID非手机号、邮箱speaker.password小米账号密码speaker.did设备名称或设备 ID须与米家 APP 中的名称逐字一致speaker.ttsCommand朗读指令来自 MIoT 规格文档如[5, 1]speaker.wakeUpCommand唤醒指令如[5, 3]speaker.streamResponse是否开启连续对话部分机型需关闭.env的关键字段只有三个OPENAI_API_KEY密钥、OPENAI_MODEL模型名、OPENAI_BASE_URL接口地址换模型时改这里。完整参数说明见 docs/settings.md。第 3 步启动服务。两种方式任选其一。Docker 方式适合不想装 Node 环境的用户docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latestWindows 终端下把$(pwd)换成配置文件绝对路径。Node.js 方式pnpm install pnpm db:gen pnpm dev看到控制台输出服务已启动再用语音喊一句小爱同学召唤傻妞音箱回应了就算成功。 接入大模型并定制助手多模型切换的原理MiGPT 走的是 OpenAI 兼容接口。任何提供 OpenAI 格式 API 的服务通义千问、Moonshot、DeepSeek 等都只需改.env里OPENAI_BASE_URL和OPENAI_MODEL两个值即可接入。豆包这类原生不支持 OpenAI 接口的模型可以部署 OneAPI 等聚合服务做一层转换再把OPENAI_BASE_URL指向它。角色设定.migpt.js里的systemTemplate是系统提示词用来约束回答风格比如要求保持精简、不超过三句话bot.name和bot.profile决定助手自称什么、性格如何。写人设的思路可参考 docs/prompt.md。唤醒词与退出词callAIKeywords定义哪些开头会直接调用 AI默认含请wakeUpKeywords进入连续对话模式exitKeywords退出该模式。进模式后不再需要每句都说小爱同学省去了反复唤醒的步骤。连续对话开关streamResponse控制是否进入连续对话exitKeepAliveAfter设定无响应多久后自动退出默认 30 秒。注意连续对话是实验性功能文档明确建议日常可关闭。️ 用起来之后的体验调优三种唤起方式小爱同学请 xxx——直接让 AI 回答小爱同学你 xxx——以角色对话方式提问小爱同学召唤 xxx——进入 AI 模式之后可直接连续提问更换 TTS 音色默认用小爱自带语音。想换音色需自建或部署一个 TTS 服务在.env填入TTS_BASE_URL并把.migpt.js的speaker.tts改为custom。配置后可用小爱同学把声音换成 xxx语音切换。完整步骤见 docs/tts.md。响应速度微调默认参数偏保守可调整checkInterval播放状态检测间隔调小能降低回复间的停顿感、checkTTSStatusAfter下发朗读指令后多久开始检测状态把onAIAsking、onAIReplied提示语置空也能省掉前后台的等待时间。⚠️ 避坑指南启动失败提示70016 登录验证失败先核对userId是否真的小米 ID、密码是否正确若触发异地登录保护需在跑 MiGPT 的同一网络下登录小米官网完成安全验证等待约 1 小时后重试。提示找不到设备did与米家设备名称不一致常见坑是多余空格、大小写、响/箱错别字建议直接复制米家中的名称。音箱无响应确认设备正在收听Pro 型号顶部指示灯常亮即有效若正在放音乐先暂停部分内部指令如播放、讲笑话不会进入对话历史天然收不到。回答慢优先换响应更快的模型再调上述速度参数别一上来就改超时和间隔改动过大反而容易乱。更多问题可在 docs/faq.md 按图索骥。 写在最后MiGPT 用一套轻量服务解决了小爱只会固定问答的痛点让大模型真正落到家用音箱上。需要说明的是项目已停止维护不再有新功能与更新但现有核心功能仍可稳定运行建议在家庭内网环境部署并把.migpt.js、.env和prisma/app.db定期备份。遇到文档没覆盖的问题可到项目 issues 页面搜索或提交反馈。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考