
小爱音箱接入 ChatGPTMiGPT 语音助手从新手到实战的完整配置【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gptMiGPT 将小米小爱音箱接入 ChatGPT、豆包等大语言模型把它变成能问答、能角色扮演的语音助手。读完本文你能独立完成部署、配置好人设参数并知道去哪里查更多资料。项目概览MiGPT 不改动音箱固件靠轮询小米开放接口工作。它通过 MIoT 和 MiNA 开放接口小米官方的设备控制 API控制音箱的播放与唤醒轮询设备对话列表拿到你的提问再调用大模型生成回复最后用 TTS文字转语音合成音频在音箱上播放。整个过程像一个站在你和音箱之间的中转站你说话它接管交给大模型再把回答念回来。核心能力包括流式语音回复、长短期记忆和自定义 TTS 音色都可在启动后按需配置。适合两类人想用 Docker 直接体验 AI 语音问答的音箱用户以及想用 Node.js 二次开发的工程师。需要说明的是项目 README 已声明停止维护部署流程目前仍可正常完成但后续不会有新功能更新。部署前准备准备工作不复杂逐项核对完再开始能避开大多数启动失败。小米账号MiGPT 用小米 ID 登录不是手机号或邮箱。到小米官网「个人信息」页查看并记下你的 ID。小爱音箱型号需在兼容清单内各型号的指令参数见 支持的小爱音箱型号。在米家 APP 的设备详情页确认型号和设备名称。大模型 API Key服务需兼容 OpenAI 格式。在服务商控制台中调用一次模型确认密钥可用。运行环境Docker 或 Node.js16开发文档建议 Node 20。用docker -v或node -v验证。网络需要能访问大模型服务接口国内网络使用 OpenAI 时可能需要代理。图按型号检索 MIoT 规格库查看音箱设备的规格文档。部署与配置主线流程是四段克隆代码、配置大模型、配置音箱、启动服务。克隆项目代码git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt确认目录中存在.env.example和.migpt.example.js两个模板文件。配置大模型服务把环境模板改名为.env填入密钥和模型名# .env OPENAI_MODELgpt-4o-mini # 模型名称 OPENAI_API_KEYsk-xxxxxxxx # API 密钥 # OPENAI_BASE_URLhttps://api.openai.com/v1 # 默认值改用其他服务商时填写若使用兼容 OpenAI 接口的国内大模型通义千问、Moonshot 等只需替换 MODEL、BASE_URL、API_KEY 三个值变量名保持不变。具体做法见 常见问题。配置音箱设备把音箱模板改名为.migpt.js填入账号与设备信息// .migpt.js节选 export default { speaker: { userId: 987654321, // 小米 ID不是手机号或邮箱 password: 123456, // 小米账号密码 did: 小爱音箱Pro, // 米家中显示的设备名称 ttsCommand: [5, 1], // 文本转语音指令 wakeUpCommand: [5, 3], // 唤醒指令 }, };ttsCommand和wakeUpCommand因型号而异小爱音箱 Pro 为[5, 1]和[5, 3]其他型号按规格库查询后填写。图MIoT 规格页中 play-text、wake-up 指令与配置参数的对应关系。模板里的bot、master、room是大模型人设设定名字、简介等可先保持默认。若回答经常说一半就停还需配置playingCommand查询播放状态的指令。图在 play-control 属性中查询 playing-state对应 playingCommand 为 [3, 1, 1]。用 Docker 启动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此模式会自动读取.env和.migpt.js。若出现数据库相关报错运行pnpm run db:reset后重启说明见 本地开发。确认生效启动成功后终端会持续输出 Speaker 状态日志。对音箱说「小爱同学请 xxx」音箱先念提示语随后播报大模型的回复说「小爱同学召唤 xxx」可进入连续对话的唤醒模式。图MiGPT 启动成功后的终端输出音箱已被召唤为 AI 助手。报错了就按提示词定位70016 是登录问题找不到设备是 did 问题Connection error 是网络问题逐条排查见 常见问题。常见问题高频问题集中在登录、设备查找和消息触发三处。提示「70016登录验证失败」小米 ID 误填成手机号或邮箱到「个人信息-小米 ID」查看正确 ID 后重试。提示「找不到设备」did与米家中设备名称不一致错别字、多余空格、大小写直接复制米家显示的名称不要手敲。音箱收到消息但不调用 AI 回复消息没有以唤醒关键词如「请」「你」开头改说「小爱同学请 xxx」或自定义callAIKeywords列表。以上流程走完你的小爱音箱就具备了与大模型连续对话的能力。更多参数、第三方 TTS 接入和运行原理见 参数设置、常见问题 和 工作原理。【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考