MiGPT完整使用指南：让小爱音箱秒变智能AI助手的终极教程

还在为小爱音箱的"人工智障"表现而烦恼吗？想让你的智能音箱真正拥有ChatGPT级别的理解能力？本教程将手把手教你如何通过MiGPT项目快速激活小爱音箱AI能力，让你的音箱秒变贴心AI助手。

为什么选择MiGPT？

MiGPT是一个革命性的开源项目，它巧妙地将小爱音箱与先进的AI大模型相结合，让你的智能家居体验升级到全新高度。通过简单的配置，你的小爱音箱就能：

• 智能问答：从"人工智障"秒变学霸，上知天文下知地理
• 角色扮演：轻松调教成完美伴侣、贴心闺蜜或专业顾问
• 连续对话：记住你们的每一次交流，越聊越默契
• 自定义音色：解锁豆包同款自然语音，告别机械感

准备工作清单

设备兼容性检查

MiGPT支持大部分小爱音箱型号，以下是经过验证的设备清单：

支持等级	设备名称	推荐配置
✅ 完美运行	小爱音箱Pro	tts:[5,1], wake:[5,3]
✅ 完美运行	小米AI音箱第二代	tts:[7,3], wake:[7,1]
✅ 完美运行	小爱智能家庭屏10	tts:[7,3], wake:[7,1]

系统要求：

• Docker部署：2GB内存，10GB存储空间
• Node.js部署：Node.js 16+，pnpm 7+

账号信息准备

在开始配置前，请准备好以下信息：

• 小米账号ID（在account.xiaomi.com查看）
• 小米账号密码
• 小爱音箱在米家APP中的设备名称

核心配置流程

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

第一步：获取项目文件

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

第二步：配置文件准备 复制配置文件模板：

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

第三步：关键参数配置

编辑.migpt.js文件，设置小米账号和设备信息：

module.exports = {
  speaker: {
    userId: "你的小米ID",
    password: "你的密码",
    did: "小爱音箱Pro",
    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

第四步：启动服务

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

开发者部署方案

适合有开发经验的用户，具体步骤包括安装Node.js环境、克隆项目、安装依赖和启动服务。

功能体验测试

成功部署后，进行以下简单测试来验证配置是否成功：

1. 语音唤醒测试 对着音箱说"小爱同学，召唤AI助手"

2. 基础问答验证 提问"今天天气如何"，应听到AI语音回复

3. 角色扮演体验 说"你现在是数学老师"，体验智能对话的乐趣

进阶玩法探索

记忆功能开启

在.migpt.js中启用记忆功能，让小爱音箱记住你们的对话：

memory: {
  enable: true,
  longTerm: { maxTokens: 2000 },
  shortTerm: { duration: 300 }
}

个性化语音设置

配置第三方TTS音色，获得更自然的语音体验。支持百度、阿里云等多种TTS服务，让你的小爱音箱拥有独特的语音个性。

智能家居控制

通过MiGPT，你的小爱音箱可以更智能地控制家中的各种设备：

• 自动调节灯光氛围
• 智能播放音乐歌单
• 联动其他智能设备

故障排查实用技巧

常见问题	快速解决方案
设备连接失败	检查小米账号两步验证，确认音箱联网状态
AI无响应	验证API密钥有效性，检查网络连通性
语音断续	关闭流式响应或调整网络带宽

使用小贴士

1. 定期更新：定期拉取最新代码，获取更好的兼容性和新功能
2. 备份配置：在升级前备份.migpt.js和.env文件
3. 社区求助：遇到问题时，可以在项目社区中寻求帮助

通过以上完整的配置流程，你已经成功将传统小爱音箱升级为智能AI助手。MiGPT不仅支持基础问答，还能实现智能家居控制、个性化角色扮演等高级功能，让你的智能家居体验更上一层楼。