5 分钟跑通 MiGPT：小爱音箱接入大模型完整指南

5 分钟跑通 MiGPT小爱音箱接入大模型完整指南【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 把小爱音箱接入 ChatGPT、豆包等大模型让普通智能音箱听懂自然语言并开口回答。本文带你从零到跑起来拉代码、改两个配置文件、启动服务家里就多一个能问答的语音管家。它解决什么痛点 深夜想听新闻懒得掏手机说“小爱同学请总结今天头条新闻”音箱让大模型生成摘要念给你听不碰屏幕、没有广告。孩子连珠炮式提问“为什么天会黑”套话答案一句就完接入大模型后能一步步解释还能接住下一问。不想要冷冰冰的助手给它起个名字、设定人设它会角色扮演每个家庭成员都能拥有自己的“专属管家”。本质是音箱负责听和说大模型负责思考MiGPT 负责把两头接起来。从零到跑起来MiGPT 最快配置方法拉代码并准备两个配置文件克隆仓库、复制两份示例配置、安装依赖git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .migpt.example.js .migpt.js cp .env.example .env pnpm install.env管大模型密钥、模型名、接口地址.migpt.js管音箱账号、设备、人设。先跑起来细节后面慢慢调。填好音箱与模型信息.migpt.js里三个关键项userId填小米 ID不是手机号或邮箱password填账号密码did填音箱在米家 App 里的名称注意空格和大小写。ttsCommand与wakeUpCommand两个数字是音箱的“朗读”和“唤醒”指令各型号数值不同查 支持型号 或自己搜规格规格里Intelligent SpeakerSIID 5下的play-text方法对应ttsCommandwake-up对应wakeUpCommand.env里只需大模型的密钥、模型名、接口地址三项换国内或国外模型都只改这几个变量的值OPENAI_API_KEYsk-... OPENAI_MODELgpt-4o OPENAI_BASE_URLhttps://api.openai.com/v1启动并验证在项目目录直接pnpm start不想自己装 Node 环境用一条 Docker 命令也行pnpm start # 或 docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest日志出现“服务已启动”后说一句“小爱同学召唤傻妞”音箱开口回答就说明接通了。跑通后“请 xxx”“你 xxx”是一问一答“召唤 xxx”会进入 AI 模式之后几轮对话不用再说“小爱同学”直接聊。让它更像“你的”助手模型怎么切换兼容 OpenAI SDK 的模型通义千问、DeepSeek 等只改.env三个变量不直接兼容的模型可经第三方 API 聚合服务转成兼容接口再接入示例见 常见问题。人设怎么定制.migpt.js的bot.profile写角色简介master.profile写你的简介性别、性格、爱好各一句即可。默认的systemTemplate系统提示词已内置聊天历史和记忆只改简介不用重写模板写法见 Prompt 说明。唤醒词怎么改callAIKeywords、wakeUpKeywords、exitKeywords分别对应一问一答、进入 AI 模式、退出 AI 模式。把“召唤”换成“唤醒”“开始”都行onEnterAI等提示语数组置空可让说话更干脆。进阶玩法记忆、TTS、连续对话长短期记忆对话历史存在本地 SQLite见 记忆模块短期记忆管当轮上下文长期记忆记偏好越用越“记得你说过”。第三方 TTS可接任意 TTS 服务含本地部署的 ChatTTS在.env配TTS_BASE_URL、.migpt.js配tts字段说“把声音换成 xxx”即可切换音色教程见 TTS 定制。连续对话开启streamResponse后音箱播完会自动听下一问部分型号播放状态查询不准需关闭对照 支持型号 表。playingCommand就是查询播放状态的指令避坑指南4 个高频问题现象登录账号失败→ 原因userId填成了手机号或邮箱 → 处理改成小米 ID。现象能连上但音箱不出声→ 原因ttsCommand与型号不匹配或did写错 → 处理对照 支持型号 查数值did与米家名称逐字核对。现象AI 不回答或特别慢→ 原因密钥失效或网络访问不到模型接口 → 处理验证密钥与OPENAI_BASE_URL打开debug看日志。现象连续对话中断或复读→ 原因部分型号播放状态查询不准 → 处理关闭streamResponse或配置playingCommand。文档与源码导航配置参数.migpt.js与.env全部字段说明支持型号音箱型号兼容性与指令参数核心源码音箱连接、记忆、对话等模块实现音箱跑起来之后人设、音色、唤醒词都可以一项项调用久了它就是“你的”。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考