MiGPT终极指南：3步打造你的专属AI语音管家

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

想让家里的智能音箱真正"聪明"起来吗？MiGPT项目为你提供了完美的解决方案！这个开源工具能将普通的小爱音箱与ChatGPT、豆包等大语言模型无缝连接，打造出真正懂你的智能语音助手。无论你是技术小白还是开发者，都能轻松上手，让传统智能音箱瞬间升级为AI管家。

🎯 MiGPT的核心价值：从"人工智障"到"智能助手"

传统智能音箱最大的痛点是什么？没错，就是那令人抓狂的"人工智障"体验——只能执行简单指令，无法理解复杂对话，更别提个性化服务了。MiGPT彻底改变了这一现状，通过大语言模型赋能，让你的小爱音箱实现质的飞跃。

📊 智能升级前后对比

MiGPT通过标准化的命令接口控制小爱音箱的各项功能

🚀 快速上手：3步完成智能升级

第一步：环境准备与项目部署

开始之前，确保你的系统满足以下基础要求：

• Node.js 16.0+ 或 Docker环境
• 小爱音箱设备（推荐小爱音箱Pro）
• 稳定的网络连接

获取项目代码：

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt pnpm install # 或使用npm install

第二步：配置文件设置

MiGPT的配置非常简单，主要通过两个文件完成：

1. 创建配置文件：

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

2. 配置音箱连接信息（编辑.migpt.js）：

module.exports = { speaker: { userId: "你的小米ID", // 在小米账号中查看 password: "你的密码", // 小米账号密码 did: "小爱音箱Pro", // 音箱在米家APP中的名称 ttsCommand: [5, 1], // TTS语音合成指令 wakeUpCommand: [5, 3] // 唤醒音箱指令 } }

3. 配置AI模型参数（编辑.env）：

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

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

第三步：启动服务与测试

完成配置后，启动MiGPT服务：

pnpm start

看到以下日志表示启动成功：

MiGPT v4.2.0 服务已启动... Speaker 🔥 召唤豆包 Speaker 🎤 你好，我是豆包，很高兴为你服务！

现在你可以尝试唤醒你的AI助手：

• "小爱同学，请介绍一下自己"
• "小爱同学，今天天气怎么样？"
• "小爱同学，召唤豆包"

🎨 深度定制：打造独一无二的AI伙伴

🤖 AI模型灵活切换

MiGPT支持多种AI模型，让你可以根据需求自由选择。除了OpenAI系列，还支持国产模型：

国产模型接入（以豆包为例）：

OPENAI_BASE_URL=你的API网关地址 OPENAI_MODEL=doubao OPENAI_API_KEY=你的豆包API密钥

通过API管理界面轻松配置各种大语言模型

🎭 个性化人设定制

在.migpt.js中，你可以深度定制AI助手的性格：

const botProfile = ` 性别：女 性格：活泼开朗、善解人意 爱好：喜欢讲笑话、分享有趣的知识 特长：精通各种生活技巧 `.trim(); const systemTemplate = ` 你是一个名叫{{botName}}的AI助手，性格{{botProfile}}。 请用第一人称回复，保持友好、幽默的风格。 `;

🔊 语音交互优化

调整唤醒词和交互关键词，让体验更自然：

speaker: { wakeUpKeywords: ["召唤豆包", "打开AI模式"], exitKeywords: ["退出豆包", "关闭AI"], onEnterAI: ["我在呢！有什么可以帮您？"], onExitAI: ["豆包已退出，期待下次为您服务"] }

通过设备型号查询功能，快速配置你的小爱音箱

🔧 高级功能：解锁更多玩法

🧠 记忆管理系统

MiGPT内置了智能记忆系统，让AI能够记住对话历史。源码位于src/services/bot/memory/目录：

• 短期记忆：记住当前会话的上下文，实现连续对话
• 长期记忆：存储重要的用户偏好和习惯，越用越懂你
• 自动清理：智能管理对话历史，避免性能下降

🎵 第三方TTS语音合成

厌倦了小爱同学的默认声音？MiGPT支持接入第三方TTS服务：

speaker: { tts: "custom", // 启用自定义TTS switchSpeakerKeywords: ["换成男生声音", "换成女生声音"] }

详细配置方法可参考官方文档：docs/tts.md

🏠 智能家居联动（实验性功能）

虽然还在开发中，但MiGPT未来计划支持智能家居控制：

• 根据对话内容自动调节灯光
• 播放符合心情的音乐
• 设置智能场景触发条件

MiGPT的播放控制配置界面，支持精细化的音频管理

💡 实用场景：让AI助手融入生活

🏡 家庭智能管家

• 早晨播报：天气预报、新闻摘要、日程提醒
• 家庭助手：菜谱查询、健康提醒、儿童教育
• 娱乐伙伴：讲笑话、播放音乐、互动游戏

📚 学习与成长伙伴

• 知识问答：随时解答各种问题
• 语言学习：外语对话练习
• 技能辅导：编程指导、生活技巧

💼 工作效率提升

• 会议助手：记录要点、提醒事项
• 信息查询：快速获取资料和数据
• 日程管理：智能规划时间安排

❓ 常见问题快速解答

Q: 无法连接小爱音箱怎么办？

A: 检查以下几点：

1. 确认小米账号密码正确（注意：是小米ID，不是手机号）
2. 确保音箱和运行MiGPT的设备在同一局域网
3. 验证音箱在米家APP中在线且可控制

Q: AI响应慢或无响应？

A: 尝试以下排查步骤：

1. 检查API密钥是否有效且未过期
2. 确认网络连接正常，可以访问AI服务
3. 查看控制台日志中的错误信息
4. 尝试更换不同的AI模型

Q: 如何切换不同的AI模型？

A: 只需修改.env文件中的OPENAI_MODEL参数，支持以下模型：

• gpt-4o（推荐，平衡性能与成本）
• gpt-4-turbo（适合长文本处理）
• 豆包、通义千问等国产模型

Q: 音箱播放声音异常？

A: 可能是TTS配置问题：

1. 检查ttsCommand参数是否正确
2. 确认音箱音量设置合适
3. 尝试重启MiGPT服务
4. 参考docs/settings.md中的指令表

🎯 技术架构亮点

MiGPT采用模块化设计，核心源码位于src/目录下：

• 轻量级架构：基于Node.js，资源占用低
• 模块化设计：易于扩展和维护
• 多模型支持：无缝切换不同AI服务
• 完善的日志系统：便于问题排查和调试

MiGPT支持多种AI大模型，让智能音箱拥有更强大的对话能力

📋 快速参考卡

启动命令速查

# Docker启动 docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest # Node.js启动 pnpm start

核心配置文件

• .env：AI模型和API配置
• .migpt.js：音箱连接和个性化设置
• docs/settings.md：详细配置说明

常用唤醒词

• "小爱同学，请xxx"
• "小爱同学，你xxx"
• "小爱同学，召唤xxx"

🌟 总结

通过MiGPT，你可以轻松将普通的小爱音箱升级为真正的AI智能助手。无论是日常对话、学习辅助还是家庭娱乐，MiGPT都能提供更加智能、个性化的体验。现在就开始你的智能家居升级之旅，打造一个真正懂你、会学习、能成长的AI语音管家！

进阶学习资源：

• 官方配置文档：docs/settings.md
• TTS深度定制：docs/tts.md
• 开发指南：docs/development.md
• 核心源码参考：src/services/

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