最完整MiGPT安装指南：3步激活AI音箱
项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt 你还在为小爱音箱的“智能体验不佳”而烦恼吗？想让家里的智能设备秒变贴心AI助手？本文将通过3个核心步骤，手把手教你将小爱音箱接入ChatGPT和豆包大模型，从环境准备到语音交互全流程覆盖，让你的智能音箱真正实现“能听会说”。
读完本文你将获得：
- 精准匹配的设备选型方案
- 两种部署模式（Docker/Node.js）的详细操作指南
- 避坑指南与常见故障解决方案
- 优化语音交互体验的高级配置技巧
一、环境准备：设备与依赖检查
1.1 兼容设备清单
MiGPT支持大部分小爱音箱型号，但不同设备的功能支持度存在差异。以下是经过验证的设备列表：
| 支持等级 | 设备名称 | 型号 | 连续对话 | 核心指令配置 |
|---|---|---|---|---|
| ✅ 完美运行 | 小爱音箱Pro | LX06 | 支持 | tts:[5,1],wake:[5,3] |
| ✅ 完美运行 | 小米AI音箱第二代 | L15A | 支持 | tts:[7,3],wake:[7,1] |
| ✅ 完美运行 | 小爱智能家庭屏10 | X10A | 支持 | tts:[7,3],wake:[7,1] |
| 🚗 正常运行 | 小爱音箱Play增强版 | L05C | 不支持 | tts:[5,3],wake:[5,1] |
| 🚗 正常运行 | 小爱触屏音箱 | LX04 | 不支持 | tts:[5,1],wake:[5,2] |
| ❌ 不支持 | 小米小爱音箱HD | SM4 | - | - |
型号查询方法：在米家APP中查看设备详情，或访问MIoT设备数据库搜索设备型号
1.2 系统环境要求
| 部署方式 | 最低配置要求 | 推荐配置 |
|---|---|---|
| Docker | 2GB内存，10GB存储空间 | 4GB内存，20GB SSD |
| Node.js | Node.js 16+，npm/pnpm 7+ | Node.js 20+，pnpm 9+ |
二、部署实施：两种安装方案
方案A：Docker一键部署（推荐新手）
步骤1：安装Docker环境
# Ubuntu/Debian系统
sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io -y
# 验证安装
docker --version # 应输出Docker version 20.10+
步骤2：获取配置文件
# 克隆仓库
git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
cd mi-gpt
# 复制配置文件模板
cp .migpt.example.js .migpt.js
cp .env.example .env
步骤3：配置核心参数
编辑.migpt.js文件，设置小米账号和设备信息：
module.exports = {
speaker: {
userId: "987654321", // 小米ID（在account.xiaomi.com查看）
password: "your_password", // 小米账号密码
did: "小爱音箱Pro", // 音箱在米家APP中的名称
ttsCommand: [5, 1], // 根据设备型号选择（参考1.1节表格）
wakeUpCommand: [5, 3] // 根据设备型号选择
},
// 其他参数保持默认
}
编辑.env文件配置AI服务：
# OpenAI配置（二选一）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o
# 或豆包配置（二选一）
DOUBAO_API_KEY=your_doubao_api_key
DOUBAO_MODEL=ERNIE-Bot-4
步骤4：启动服务
# 构建并启动容器
docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest
# 查看运行状态
docker ps | grep mi-gpt # 应显示running状态
方案B：Node.js源码部署（开发者首选）
步骤1：安装依赖环境
# 安装Node.js（以Ubuntu为例）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证版本
node -v # 应输出v20.14.0+
pnpm -v # 应输出9.1.1+
步骤2：获取源码并安装依赖
git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
cd mi-gpt
pnpm install # 安装项目依赖
pnpm db:gen # 初始化数据库
步骤3：配置与启动
# 同方案A步骤3配置.migpt.js和.env文件
# 开发模式启动
pnpm dev
# 或生产模式启动
pnpm build
pnpm start
三、激活与验证：3分钟完成交互测试
3.1 基础功能验证
成功启动服务后，进行以下测试：
- 语音唤醒：对着音箱说“小爱同学，召唤AI助手”
- 基础问答：提问“今天北京天气如何”，应听到AI语音回复
- 角色扮演：说“你现在是数学老师，解释什么是勾股定理”
3.2 高级配置优化
记忆功能开启
修改.migpt.js启用长短期记忆：
memory: {
enable: true,
longTerm: {
maxTokens: 2000 // 长期记忆上下文长度
},
shortTerm: {
duration: 300 // 短期记忆保留时间（秒）
}
}
自定义TTS语音
配置豆包同款音色（需申请百度API）：
speaker: {
tts: "baidu",
ttsConfig: {
appId: "your_appid",
apiKey: "your_apikey",
secretKey: "your_secretkey",
voice: "duxiaoyao" // 豆包音色
}
}
3.3 故障排查指南
| 常见问题 | 解决方案 |
|---|---|
| 设备连接失败 | 1. 检查小米账号是否开启两步验证 2. 确认音箱已在米家APP中正常联网 3. 尝试重启音箱后重新运行 |
| AI无响应 | 1. 检查API密钥是否有效 2. 验证网络连通性（ ping api.openai.com）3. 查看日志： docker logs [container_id] |
| 语音断断续续 | 1. 关闭流式响应：streamResponse: false2. 调整网络带宽，确保上行≥2Mbps |
四、总结与进阶
通过本文3个步骤，你已成功将传统小爱音箱升级为AI语音助手。MiGPT不仅支持基础问答，还可通过配置实现智能家居控制、日程管理等高级功能。建议后续关注：
提示：定期执行
git pull更新代码，或通过Docker命令docker pull idootop/mi-gpt:latest获取最新镜像，以获得更好的兼容性和功能体验。
如果觉得本指南对你有帮助，请点赞收藏，并关注获取更多智能家居AI改造技巧！下期我们将揭秘MiGPT的工作原理，教你深度定制AI交互逻辑。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
