小爱音箱AI升级终极指南：5步快速接入ChatGPT和豆包大模型

【免费下载链接】mi-gpt 🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。 项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt

你是否曾希望家中的小爱音箱能像ChatGPT一样聪明，回答你的各种问题？现在，通过MiGPT项目，你可以轻松将普通小爱音箱升级为智能AI语音助手。本文将为你提供一个完整的简单教程，让你快速实现这一目标。

🎯 为什么选择MiGPT改造小爱音箱？

MiGPT是一个开源项目，专门为小米智能音箱设计，让你能够将ChatGPT、豆包等大语言模型接入到小爱音箱中。通过这个改造，你的小爱音箱将获得以下强大功能：

• 🤖 智能问答能力：从"人工智障"变身学霸，回答各种复杂问题
• 🎭 角色扮演模式：自定义AI角色，打造专属语音助手
• 💬 流式响应对话：实时交互，回答不再等待
• 🧠 长短期记忆：记住对话历史，越聊越懂你
• 🔊 自定义语音：更换小爱同学的原生语音，使用豆包同款音色

📋 准备工作清单

在开始升级之前，请确保你已准备好以下资源：

资源类型	具体要求
硬件设备	兼容的小爱音箱型号（推荐小爱音箱Pro）
电脑/服务器	4GB以上内存，用于运行MiGPT服务
软件环境	Docker或Node.js 20+
账号准备	小米账号、大模型API账号
网络条件	稳定的宽带连接

设备兼容性检查

首先确认你的小爱音箱型号是否兼容。在米家APP中查看设备详情，找到类似"LX06"或"L15A"的型号标识。大部分小爱音箱型号都支持，但小爱音箱Pro能提供最完美的运行体验。

🚀 快速开始：Docker部署方案（适合新手）

对于不熟悉代码的用户，Docker部署是最简单快捷的方式。只需几个命令，就能完成整个部署过程。

步骤1：安装Docker环境

如果你的电脑或服务器还没有安装Docker，请先执行以下命令：

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

步骤3：配置关键参数

MiGPT需要两个配置文件：.migpt.js和.env。首先复制示例文件：

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

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

module.exports = {
  speaker: {
    userId: "你的小米ID",      // 在account.xiaomi.com查看
    password: "你的密码",      // 小米账号密码
    did: "小爱音箱Pro",        // 音箱在米家APP中的名称
    ttsCommand: [5, 1],       // TTS指令
    wakeUpCommand: [5, 3]     // 唤醒指令
  }
}

编辑.env文件，配置AI服务参数。这里以OpenAI为例：

# OpenAI配置
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o

步骤4：启动MiGPT服务

使用Docker命令启动服务：

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

启动后，运行docker ps | grep mi-gpt查看服务状态。

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

如果你需要更多定制化功能，或者想深入了解项目原理，可以选择Node.js源码部署方式。

环境准备

确保你的系统已安装Node.js 20+和pnpm：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g pnpm

项目初始化

克隆项目并安装依赖：

git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
cd mi-gpt
pnpm install
pnpm db:gen

启动开发服务

配置好.migpt.js和.env文件后，启动服务：

pnpm dev

服务启动成功后，你会看到MiGPT的标志和状态信息。

🔧 核心配置详解

设备指令配置

MiGPT通过特定的指令控制小爱音箱。在.migpt.js文件中，ttsCommand和wakeUpCommand是关键配置：

这两个参数对应小爱音箱的API指令，格式为[设备ID, 方法ID]。例如[5, 1]表示设备ID为5，方法ID为1的TTS播放指令。

AI模型选择与配置

MiGPT支持多种大语言模型，不仅仅是OpenAI。你可以在.env文件中配置不同的模型：

# 通义千问配置示例
OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
OPENAI_MODEL=qwen-turbo
OPENAI_API_KEY=你的通义千问API密钥

# 豆包大模型配置（通过OneAPI转换）
OPENAI_BASE_URL=http://你的oneapi地址/v1
OPENAI_MODEL=豆包模型名称
OPENAI_API_KEY=你的API密钥

唤醒词与交互设置

你可以自定义AI的唤醒词和交互方式：

callAIKeywords: ["请", "傻妞"],  // 调用AI的关键词
wakeUpKeywords: ["召唤傻妞", "打开傻妞"],  // 唤醒AI的关键词
exitKeywords: ["退出傻妞", "关闭傻妞"],  // 退出AI模式的关键词

🎨 个性化定制功能

角色扮演与人格设定

通过修改系统Prompt，你可以为AI设定不同的人格：

systemTemplate: "你是一个博学多识的助手，性格活泼开朗，喜欢用幽默的方式回答问题。请保持回答简洁明了，不超过3句话。"

自定义语音体验

厌倦了小爱同学的原生语音？MiGPT支持第三方TTS服务：

tts: "third-party",  // 使用第三方TTS
ttsConfig: {
  provider: "doubao",  // 豆包TTS
  voice: "female-1"    // 选择音色
}

🔍 常见问题与解决方案

问题1：服务启动失败

• 检查网络连接：确保服务器能正常访问互联网
• 验证API密钥：确认OpenAI或其他模型的API密钥有效
• 查看日志：运行docker logs [容器ID]查看详细错误信息

问题2：小爱音箱无响应

• 检查账号密码：确认小米账号和密码正确
• 验证设备名称：确保did参数与米家APP中的设备名称一致
• 重启设备：尝试重启小爱音箱后重新连接

问题3：AI回答速度慢

• 优化配置参数：调整.migpt.js中的相关参数
• 检查网络延迟：确保网络连接稳定
• 选择合适模型：尝试使用响应更快的模型

🚀 高级应用场景

场景1：家庭学习助手

将小爱音箱改造成孩子的学习伙伴，可以回答各种学科问题，帮助完成作业。

场景2：智能家居控制中心

通过自定义指令，让AI控制其他智能家居设备，实现语音控制全家电器。

场景3：个性化娱乐助手

根据你的喜好推荐音乐、电影，甚至讲睡前故事。

📚 深入学习资源

如果你对MiGPT的更多功能感兴趣，可以查阅以下文档：

• 官方配置文档：docs/settings.md
• 常见问题解答：docs/faq.md
• 工作原理详解：docs/how-it-works.md
• 第三方TTS配置：docs/tts.md

🎉 开始你的AI改造之旅

通过本文的指导，你已经掌握了将小爱音箱升级为AI语音助手的关键步骤。无论是选择简单的Docker部署，还是进行深度定制的Node.js源码部署，都能让你体验到智能语音助手的强大功能。

记住，改造过程可能需要一些耐心和调试，但一旦成功，你将拥有一个真正懂你的智能家居伙伴。现在就开始行动，让你的小爱音箱变得更加智能吧！

【免费下载链接】mi-gpt 🏠 将小爱音箱接入 ChatGPT 和豆包，改造成你的专属语音助手。 项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt