MiGPT安装全攻略：3步让小爱音箱变身AI语音助手

还在为小爱音箱的智能程度不够高而烦恼吗？想拥有一个真正能听会说的AI语音助手吗？MiGPT项目正是你需要的解决方案！通过简单配置，就能将传统小爱音箱接入ChatGPT和豆包大模型，实现智能语音交互体验。本文将从设备选择到功能配置，手把手教你完成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的设备详情页面可以查看具体型号信息

部署方式：选择最适合的安装方案

方案一：Docker快速部署（推荐新手）

Docker方式适合没有技术背景的普通用户，操作简单且不易出错。

准备工作：

• 确保设备内存≥2GB，存储空间≥10GB
• 已安装Docker环境

操作步骤：

1. 获取项目文件

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
cd mi-gpt

2. 复制配置文件模板

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

3. 配置核心参数 编辑.migpt.js文件，填入你的小米账号信息：

module.exports = {
  speaker: {
    userId: "你的小米ID",
    password: "你的密码",
    did: "小爱音箱Pro",
    ttsCommand: [5, 1],
    wakeUpCommand: [5, 3]
  }
}

4. 配置AI服务密钥 在.env文件中设置API密钥：

OPENAI_API_KEY=sk-你的API密钥
OPENAI_MODEL=gpt-4o

5. 启动服务

docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest

方案二：Node.js源码部署（适合开发者）

如果你有一定的技术基础，或者希望进行二次开发，推荐使用源码部署方式。

环境要求：

• Node.js 16.0及以上版本
• pnpm或npm包管理器

安装流程：

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

# 安装依赖
pnpm install
pnpm db:gen

# 开发模式启动
pnpm dev

功能验证：测试你的AI助手

完成部署后，进行以下测试确保一切正常：

基础功能测试

1. 语音唤醒：对着音箱说"小爱同学，召唤AI助手"
2. 智能问答：提问"帮我写一份工作周报"
3. 角色扮演：说"你现在是英语老师，教我一些日常用语"

高级功能配置

启用记忆功能，让AI助手记住你们的对话：

memory: {
  enable: true,
  longTerm: {
    maxTokens: 2000
  }
}

常见问题与解决方案

问题现象	排查步骤
音箱无响应	1. 检查小米账号密码是否正确 2. 确认音箱已联网 3. 重启音箱后重试
AI服务异常	1. 验证API密钥有效性 2. 检查网络连接状态 3. 查看服务日志信息
语音断断续续	1. 关闭流式响应功能 2. 确保网络带宽充足

使用技巧与优化建议

提升交互体验：

• 设置个性化唤醒词，让交互更有趣
• 配置常用场景，实现一键调用
• 定期更新项目，获取最新功能

通过以上三个核心步骤，你已成功将普通小爱音箱升级为智能AI语音助手。MiGPT不仅支持基础问答，还能通过配置实现智能家居控制、日程管理等高级功能。现在就开始体验真正的智能语音交互吧！