MiGPT终极指南：如何将小爱音箱改造成AI语音助手

在智能家居日益普及的今天，你是否觉得小爱音箱的语音助手功能还不够智能？MiGPT项目正是为解决这一痛点而生，它能将小爱音箱接入ChatGPT、豆包等大语言模型，让你的智能音箱瞬间拥有媲美专业AI助手的对话能力。本文将为你提供完整的MiGPT部署与使用指南，无论是技术爱好者还是普通用户，都能快速上手。## 项目概览：智能家居的AI进化MiGPT是一个开源项目，它巧妙地将小爱音箱与大语言模型相

周风队

307人浏览 · 2026-05-12 08:19:21

周风队 · 2026-05-12 08:19:21 发布

MiGPT终极指南：如何将小爱音箱改造成AI语音助手

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

项目概览：智能家居的AI进化

MiGPT是一个开源项目，它巧妙地将小爱音箱与大语言模型相结合，为传统智能音箱注入了AI灵魂。通过简单的配置，你的小爱音箱就能从简单的指令执行器升级为能理解复杂语义、进行深度对话的智能伙伴。

核心价值定位

智能化升级：让小爱音箱突破原厂限制，支持连续对话和上下文理解
多模型支持：不仅支持OpenAI的ChatGPT，还能接入豆包、通义千问等多种大模型
个性化定制：支持角色扮演、自定义唤醒词、个性化回复风格
开源免费：完全开源，社区驱动，持续更新

快速上手：5分钟完成基础部署

环境准备清单

在开始部署前，你需要准备以下资源：

项目	要求说明
小爱音箱	推荐小爱音箱Pro，其他型号请查看兼容性文档
小米账号	用于连接小爱音箱，需在account.xiaomi.com查看小米ID
服务器/电脑	内存≥2GB，可运行Docker或Node.js环境
网络环境	稳定的互联网连接，能访问AI模型API
AI模型API	OpenAI API密钥或兼容的大模型服务

Docker一键部署（推荐新手）

对于不熟悉代码的用户，Docker部署是最简单的方式：

获取项目代码

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",        // 音箱在米家APP中的名称
    ttsCommand: [5, 1],       // 语音合成指令
    wakeUpCommand: [5, 3]     // 唤醒指令
  }
}

编辑.env文件，配置AI模型：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o

启动服务

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

✅ 验证检查点：运行docker ps | grep mi-gpt查看容器状态，确保服务正常运行

Node.js源码部署（适合开发者）

如果你需要更多定制功能，可以选择源码部署：

# 安装依赖
git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt
cd mi-gpt
pnpm install
pnpm db:gen

# 启动服务
pnpm dev

⚠️ 风险提示：源码部署需要Node.js 20+环境，安装依赖过程可能需要较长时间

核心功能详解：解锁AI音箱全部潜能

AI对话能力升级

MiGPT最核心的功能是让小爱音箱具备真正的AI对话能力。配置成功后，你可以通过以下方式与AI互动：

直接提问："小爱同学，请解释什么是量子计算？"
角色扮演："小爱同学，你现在是我的英语老师"
连续对话：进入AI模式后，无需重复唤醒词

设备控制参数配置

MiGPT通过特定的指令参数来控制小爱音箱，这些参数对应设备的底层服务接口：

功能类型	指令参数	作用说明
语音合成	[5, 1]	控制小爱音箱播放AI生成的语音回复
唤醒设备	[5, 3]	激活音箱的AI对话模式
播放状态	[3, 1, 1]	检测音箱当前是否在播放音频

个性化角色设置

你可以在配置文件中为AI助手设置独特的个性：

module.exports = {
  bot: {
    name: "智能管家",
    profile: "性别中性，性格温和有礼，知识渊博，擅长解答各种问题"
  },
  master: {
    name: "主人",
    profile: "科技爱好者，喜欢尝试新事物"
  },
  room: {
    name: "智能家居中心",
    description: "智能管家与主人的日常对话空间"
  }
}

进阶配置指南：深度定制你的AI助手

多模型接入方案

MiGPT不仅支持OpenAI，还能接入多种大语言模型：

# 通义千问配置示例
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=你的OneAPI密钥

语音合成优化

如果你对小爱音箱的原生语音不满意，可以接入第三方TTS服务：

module.exports = {
  speaker: {
    tts: "custom",  // 使用自定义TTS
    ttsBaseUrl: "http://你的TTS服务地址/api",
    switchSpeakerKeywords: ["切换声音", "换一个声音"]
  }
}

响应速度调优

AI响应速度过慢？尝试以下优化配置：

module.exports = {
  speaker: {
    checkInterval: 500,  // 播放状态检测间隔（毫秒）
    checkTTSStatusAfter: 2,  // TTS指令后开始检测的等待时间（秒）
    onAIAsking: [],  // 关闭开始回答提示语
    onAIReplied: []   // 关闭结束回答提示语
  }
}