MiGPT完全安装指南：4步将小爱音箱升级AI语音助手

还在为小爱音箱的"智能"程度不够而烦恼吗？通过MiGPT项目，你可以将家中的小爱音箱接入ChatGPT和豆包等大语言模型，实现真正的智能语音交互体验。本文将手把手教你完成从小白到精通的完整安装过程。

MiGPT AI语音助手演示效果

📋 一、环境准备与设备检查

兼容设备清单

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]

提示：在米家APP中查看设备详情可获取准确型号信息

系统要求对比

部署方式	最低配置	推荐配置	适用场景
Docker	2GB内存，10GB存储	4GB内存，20GB SSD	新手用户、快速部署
Node.js	Node.js 16+	Node.js 20+	开发者、自定义需求

🚀 二、部署方案选择与配置

方案A：Docker一键部署（推荐新手）

Docker部署配置示意图

步骤1：安装Docker环境

# Ubuntu/Debian系统安装
sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io -y

# 验证安装成功
docker --version

步骤2：获取项目文件

# 克隆MiGPT仓库
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: "你的小米ID",      // 在account.xiaomi.com查看
    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环境

# 安装Node.js 20版本
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装pnpm包管理器
npm install -g pnpm

步骤2：安装项目依赖

# 获取项目代码
git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
cd mi-gpt

# 安装依赖并初始化
pnpm install
pnpm db:gen

步骤3：配置与启动

# 同方案A配置.migpt.js和.env文件

# 开发模式启动
pnpm dev

# 生产模式构建启动
pnpm build
pnpm start

🎯 三、功能验证与实战操作

基础功能测试

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

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

语音指令搜索配置方法

高级功能配置

记忆功能开启

修改.migpt.js启用记忆功能：

memory: {
  enable: true,
  longTerm: {
    maxTokens: 2000  // 长期记忆上下文长度
  },
  shortTerm: {
    duration: 300    // 短期记忆保留时间（秒）
  }
}

性能优化配置

speaker: {
  tts: "xiaoai",           // 使用小爱自带TTS引擎
  onAIAsking: [],          // 关闭AI开始回答提示语
  onAIReplied: [],         // 关闭AI结束回答提示语
  checkInterval: 500,      // 降低回复间隔（毫秒）
  checkTTSStatusAfter: 3   // TTS状态检测时间（秒）
}

🔧 四、故障排查与高级技巧

常见问题解决方案

问题现象	解决方案
设备连接失败	1. 检查小米账号两步验证 2. 确认音箱正常联网 3. 重启音箱重试
AI无响应	1. 验证API密钥有效性 2. 检查网络连通性 3. 查看容器日志
语音断续	1. 关闭流式响应 2. 确保上行带宽≥2Mbps

网络问题处理

对于国内访问OpenAI的问题，可通过以下方式解决：

# 设置代理
HTTP_PROXY=http://127.0.0.1:7890

# 或使用国内大模型
OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
OPENAI_MODEL=qwen-turbo

设备识别问题

如果出现设备找不到的错误，可开启调试模式获取设备DID：

speaker: {
  debug: true,
  enableTrace: true  // 跟踪Mi Service日志
}

🎉 总结与进阶建议

通过以上4个步骤，你已经成功将传统小爱音箱升级为智能AI语音助手。MiGPT不仅支持基础问答，还可以通过配置实现更多高级功能。

后续优化建议：

• 定期更新项目版本获取新功能
• 探索自定义语音指令开发
• 关注社区插件市场获取扩展功能

提示：保持项目更新可获取更好的兼容性和功能体验，使用git pull更新代码或docker pull idootop/mi-gpt:latest获取最新镜像。

现在就开始体验你的AI智能音箱吧！如有任何问题，可查阅项目文档中的常见问题解答。