最完整MiGPT安装指南：3步激活AI音箱

你还在为小爱音箱的“智能体验不佳”而烦恼吗？想让家里的智能设备秒变贴心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 基础功能验证

成功启动服务后，进行以下测试：

1. 语音唤醒：对着音箱说“小爱同学，召唤AI助手”
2. 基础问答：提问“今天北京天气如何”，应听到AI语音回复
3. 角色扮演：说“你现在是数学老师，解释什么是勾股定理”

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: false 2. 调整网络带宽，确保上行≥2Mbps

四、总结与进阶

通过本文3个步骤，你已成功将传统小爱音箱升级为AI语音助手。MiGPT不仅支持基础问答，还可通过配置实现智能家居控制、日程管理等高级功能。建议后续关注：

• 官方视频教程：获取最新功能演示
• 自定义技能开发：扩展专属语音指令
• 社区插件市场：获取第三方开发的实用功能模块

提示：定期执行git pull更新代码，或通过Docker命令docker pull idootop/mi-gpt:latest获取最新镜像，以获得更好的兼容性和功能体验。

如果觉得本指南对你有帮助，请点赞收藏，并关注获取更多智能家居AI改造技巧！下期我们将揭秘MiGPT的工作原理，教你深度定制AI交互逻辑。