当前位置：首页 > news >正文

让小爱音箱秒变AI助手：MiGPT项目完整配置指南

news 2026/5/4 21:20:13

让小爱音箱秒变AI助手：MiGPT项目完整配置指南

【免费下载链接】mi-gpt🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt

你是否曾对小爱音箱的"人工智障"回答感到失望？是否渴望拥有一个真正能理解你、陪伴你的智能语音助手？今天，我将为你介绍一个神奇的开源项目——MiGPT，它能将普通的小爱音箱接入ChatGPT和豆包等大语言模型，瞬间升级为真正的AI语音助手。无论你是技术爱好者还是普通用户，只需简单配置，就能让家中的小爱音箱变得聪明起来。

MiGPT：重新定义智能家居交互体验

MiGPT不仅仅是一个技术项目，它代表着智能家居体验的全面升级。传统的小爱同学只能执行简单的指令，而MiGPT赋予了它真正的理解能力和对话能力。想象一下，当你问"今天适合穿什么衣服？"时，它不仅告诉你天气预报，还能根据你的穿衣风格给出搭配建议；当你心情不好时，它能主动播放舒缓音乐，调节室内灯光氛围。

图：MiGPT成功启动后的控制台界面，显示服务状态和AI交互日志

这个开源项目让小爱音箱从简单的指令执行者，变成了能理解上下文、个性化对话的智能伙伴。它支持多种AI模型，包括GPT-4、豆包、通义千问等，让你可以根据需求灵活选择最适合的AI大脑。

核心功能亮点：为什么选择MiGPT？

🎭 个性化角色扮演

你可以将小爱音箱调教成任何角色，从贴心情人到知识渊博的导师。通过简单的配置文件修改，就能定义AI助手的性格、说话风格和兴趣爱好。

💬 流式响应体验

告别生硬的语音片段，MiGPT支持流式响应，让AI的回答更加流畅自然。对话过程中几乎没有停顿感，就像与真人交流一样顺畅。

🧠 记忆对话历史

MiGPT具备长短期记忆功能，能记住你们之间的每一次对话。这意味着AI助手会越聊越懂你，建立真正的个性化交互体验。

🔊 自定义语音音色

厌倦了小爱同学的标准声音？MiGPT支持自定义TTS服务，你可以换成豆包同款音色，甚至使用本地部署的ChatTTS，打造独一无二的语音体验。

快速入门：五分钟完成基础配置

准备工作清单

在开始配置前，请确保准备好以下内容：

小爱音箱设备：推荐小爱音箱Pro（完美运行），其他主流型号也基本支持
小米账户：需要小米ID和密码（注意：小米ID不是手机号或邮箱）
Node.js环境：版本16.0或更高
稳定的网络连接：确保音箱和运行MiGPT的设备在同一局域网

获取项目代码

首先克隆项目仓库到本地：

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install

创建配置文件

复制项目中的示例配置文件并开始编辑：

cp .migpt.example.js .migpt.js cp .env.example .env

编辑.migpt.js文件，配置小爱音箱连接参数：

module.exports = { speaker: { userId: "你的小米ID", // 小米账户ID password: "你的小米密码", // 小米账户密码 did: "小爱音箱 Pro", // 音箱名称或设备ID ttsCommand: [5, 1], // TTS语音合成指令 wakeUpCommand: [5, 3] // 唤醒指令 } }

图：智能音箱服务接口文档，显示SIID和AID对应关系，帮助配置正确的指令参数

配置AI模型API

编辑.env文件，添加AI服务配置。如果你使用OpenAI：

OPENAI_API_KEY=你的API密钥 OPENAI_MODEL=gpt-4o OPENAI_BASE_URL=https://api.openai.com/v1

如果你使用国产大模型如通义千问：

OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1 OPENAI_MODEL=qwen-turbo OPENAI_API_KEY=通义千问API_KEY

图：302.AI平台的API超市界面，展示如何获取各种AI服务的API密钥

个性化定制：打造专属AI助手

定义AI助手性格

通过修改系统提示词，你可以完全定制AI助手的性格和对话风格。在.migpt.js文件中，你可以设置：

const botProfile = ` 性别：女 性格：活泼开朗、幽默风趣 爱好：喜欢讲笑话、关心他人 特长：知识渊博，擅长解答各种问题 `.trim(); const systemTemplate = `请重置所有之前的上下文。现在，你将扮演一个名为{{botName}}的角色... `;

配置唤醒关键词

让AI助手更符合你的使用习惯：

speaker: { // 当消息以下面的关键词开头时，会调用AI来回复消息 callAIKeywords: ["请", "你", "豆包"], // 当消息以下面的关键词开头时，会进入AI唤醒状态 wakeUpKeywords: ["打开", "进入", "召唤"], // 当消息以下面的关键词开头时，会退出AI唤醒状态 exitKeywords: ["关闭", "退出", "再见"], // 进入AI模式的欢迎语 onEnterAI: ["你好，我是豆包，很高兴为你服务！"], }

选择AI模型

MiGPT支持多种AI模型，你可以根据需求灵活切换：

GPT-4o：平衡性能与成本，适合日常使用
GPT-4-turbo：长文本处理能力强，适合复杂对话
豆包：国产优秀模型，响应速度快，中文优化好
通义千问：阿里云大模型，中文理解能力强
本地部署模型：通过API接入本地LLM，保护隐私

图：302.AI平台的Model Arena页面，展示支持的各种大语言模型

实战应用场景：MiGPT能为你做什么？

场景一：家庭知识问答助手

"小爱同学，请解释一下量子计算的基本原理" "小爱同学，帮我制定一个健身计划" "小爱同学，这道数学题怎么做？"

场景二：个性化陪伴聊天

"小爱同学，今天心情不好，给我讲个笑话吧" "小爱同学，如果你是电影导演，会拍什么样的电影？" "小爱同学，给我推荐几本好书"

场景三：智能学习伙伴

"小爱同学，帮我复习一下英语语法" "小爱同学，Python中的装饰器是什么？" "小爱同学，帮我分析这篇文章的主要观点"

图：通过设备型号查询获取小爱音箱规格信息，确保配置参数正确匹配

场景四：创意助手

"小爱同学，帮我写一首关于春天的诗" "小爱同学，给我的产品想个广告语" "小爱同学，策划一个周末家庭活动方案"

常见问题与解决方案

Q：支持哪些型号的小爱音箱？

A：大部分型号的小爱音箱都支持，推荐使用小爱音箱Pro（完美运行）。具体兼容型号可查看项目文档。注意：本项目暂不支持小度音箱、天猫精灵、HomePod等智能音箱设备。

Q：除了OpenAI还支持哪些模型？

A：理论上兼容OpenAI SDK的模型都支持，包括通义千问、零一万物、Moonshot、DeepSeek等。对于不兼容的模型如豆包，可以通过第三方API聚合工具转换。

Q：AI回答速度太慢怎么办？

A：可以调整.migpt.js中的配置参数优化响应速度：

使用小爱自带的TTS引擎：tts: "xiaoai"
关闭AI开始回答时的提示语：onAIAsking: []
调整连续对话参数：checkInterval: 500

Q：如何更换AI助手的语音？

A：MiGPT支持自定义TTS服务，包括本地部署的ChatTTS等。详细配置教程请查看项目中的docs/tts.md文档。

Q：出现连接问题怎么办？

A：首先确保小爱音箱和运行MiGPT的设备在同一局域网。检查小米ID和密码是否正确，确保没有开启二次验证。如果问题持续，可以尝试重启小爱音箱和MiGPT服务。

高级配置技巧

优化响应速度

通过调整配置参数，可以显著提升AI响应速度：

speaker: { // 使用小爱自带的TTS引擎，减少网络延迟 tts: "xiaoai", // 关闭不必要的提示语 onAIAsking: [], onAIReplied: [], // 调整连续对话参数 streamResponse: true, checkInterval: 500, // 降低检测间隔 checkTTSStatusAfter: 2, // 提前开始检测 }

启用连续对话

部分型号的小爱音箱支持连续对话功能，可以让对话更加自然流畅：

speaker: { streamResponse: true, // 启用连续对话 exitKeepAliveAfter: 30, // 无响应30秒后自动退出 checkInterval: 1000, // 播放状态检测间隔 }

自定义TTS服务

如果你对语音质量有更高要求，可以接入第三方TTS服务：

speaker: { tts: "custom", // 使用自定义TTS ttsBaseUrl: "http://192.168.1.100:8080/api/tts", }

图：Play Control接口文档，显示音频播放状态控制参数，帮助优化语音交互体验

Docker部署方案

对于不熟悉Node.js环境的用户，推荐使用Docker部署：

# 拉取最新镜像 docker pull idootop/mi-gpt:latest # 运行容器 docker run -d \ --name mi-gpt \ --env-file .env \ -v $(pwd)/.migpt.js:/app/.migpt.js \ idootop/mi-gpt:latest

Docker部署的优势：