最完整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中查看设备详情

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

步骤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（在个人信息-小米ID查看）
    password: "your_password",  // 小米账号密码
    did: "小爱音箱Pro",    // 音箱在米家APP中的名称
    ttsCommand: [5, 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

方案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
pnpm -v

步骤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
  }
}

性能优化配置

speaker: {
  tts: "xiaoai",
  onAIAsking: [],
  onAIReplied: [],
  checkInterval: 500,
  checkTTSStatusAfter: 3
}

3.3 故障排查指南

常见问题	解决方案
设备连接失败	1. 检查小米账号是否开启两步验证 2. 确认音箱已在米家APP中正常联网 3. 尝试重启音箱后重新运行
AI无响应	1. 检查API密钥是否有效 2. 验证网络连通性 3. 查看日志：docker logs [container_id]
语音断断续续	1. 关闭流式响应：streamResponse: false 2. 调整网络带宽，确保上行≥2Mbps

四、总结与进阶

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

建议后续关注项目文档中的开发指南和高级配置技巧，以获得更好的使用体验。

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