MiGPT终极指南：快速将小爱音箱接入ChatGPT和豆包大模型

在智能家居日益普及的今天，你是否希望家中的小爱音箱不再只是简单的语音助手，而是能像ChatGPT一样聪明、像豆包一样贴心的AI伙伴？MiGPT正是这样一个开源项目，它能将普通的小爱音箱接入ChatGPT、豆包等大语言模型，让你的智能家居设备实现从"人工智障"到"人工智能"的华丽蜕变。本文将从项目概览、功能特色到实战部署，为你提供一份完整的技术指南。## 项目概览与价值定位MiGPT是一个开

倪炎墨

335人浏览 · 2026-05-12 08:19:38

倪炎墨 · 2026-05-12 08:19:38 发布

MiGPT终极指南：快速将小爱音箱接入ChatGPT和豆包大模型

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

项目概览与价值定位

MiGPT是一个开源项目，通过对接小米IoT生态接口，让小爱音箱能够调用ChatGPT、豆包等主流大语言模型，实现智能对话、角色扮演、流式响应等高级功能。这个项目的核心价值在于：让普通家庭用户也能轻松享受AI技术带来的便利，无需复杂的编程知识，就能将家中的小爱音箱升级为真正的智能语音助手。

传统的智能音箱往往受限于厂商预设的功能和算法，回答问题的深度和广度有限。MiGPT打破了这一限制，通过接入大语言模型，让小爱音箱能够回答复杂问题、进行深度对话，甚至扮演特定角色与你互动。无论是学习辅导、情感陪伴，还是日常娱乐，MiGPT都能让你的智能家居体验提升一个层次。

核心功能特色展示

MiGPT提供了丰富的功能特性，让你的小爱音箱焕然一新：

🎓 AI智能问答

接入大模型后的小爱音箱不再是简单的指令执行器，而是真正的知识助手。无论是学术问题、生活常识，还是专业咨询，都能得到准确且深入的回答。

🎭 角色扮演系统

通过简单的配置，你可以让小爱音箱扮演任何角色：可以是你的贴心闺蜜、知识渊博的老师，甚至是科幻电影中的智能助手。系统提供了灵活的配置选项，让你轻松定制AI的性格和对话风格。

💬 流式响应机制

告别等待！MiGPT支持流式响应，AI的回复会实时传输到小爱音箱，就像真人对话一样自然流畅，大大提升了交互体验的真实感。

🧠 智能记忆功能

MiGPT具备长短期记忆能力，能够记住你们之间的对话历史。这意味着AI会越来越了解你的偏好和习惯，对话也会越来越默契自然。

🔊 多音色TTS支持

厌倦了小爱同学的单一音色？MiGPT支持接入豆包等第三方TTS服务，提供多种音色选择，让对话更加生动有趣。

图：智能音箱服务参数配置界面，展示ttsCommand和wakeUpCommand的映射关系

快速入门指南

环境准备

在开始部署前，请确保你具备以下条件：

一台兼容的小爱音箱（推荐小爱音箱Pro）
一台运行Docker或Node.js的服务器/电脑
小米账号和密码
大模型API密钥（如OpenAI、豆包等）

设备兼容性检查

首先确认你的小爱音箱型号是否兼容。可以在米家APP中查看设备详情，找到类似"LX06"或"L15A"的型号标识。常见的兼容型号包括：

设备型号	兼容性	推荐功能
小爱音箱Pro (LX06)	⭐⭐⭐⭐⭐	完整功能支持
小爱音箱Play增强版 (L05C)	⭐⭐⭐⭐	基础功能可用
小爱音箱Art (LX05A)	⭐⭐⭐	部分功能受限

部署方式选择

MiGPT提供两种部署方式，满足不同用户的需求：

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",      // 在account.xiaomi.com查看
    password: "你的密码",      // 小米账号密码
    did: "小爱音箱Pro",        // 音箱在米家APP中的名称
    ttsCommand: [5, 1],       // TTS指令参数
    wakeUpCommand: [5, 3]     // 唤醒指令参数
  }
}

配置AI服务：打开.env文件，设置大模型API参数：

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

# 豆包配置示例
DOUBAO_API_KEY=your_doubao_api_key

启动服务：

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

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

如果你有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

初始化项目：

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

启动开发服务：

pnpm dev

图：MiGPT服务启动成功界面，显示版本信息和运行状态

配置与个性化设置

核心配置文件详解

MiGPT的配置主要通过两个文件实现：.migpt.js和.env。以下是关键配置项的详细说明：

角色与对话设置

在.migpt.js中，你可以定义AI的角色和对话风格：

module.exports = {
  systemTemplate: "你是一个博学多识的助手，请用友好、专业的语气回答问题。",
  bot: {
    name: "智能助手",
    profile: "性格开朗，知识渊博，乐于助人"
  },
  master: {
    name: "用户",
    profile: "对技术感兴趣，喜欢探索新事物"
  },
  room: {
    name: "智能对话室",
    description: "用户与智能助手的日常交流"
  }
}

AI唤醒关键词配置

你可以自定义触发AI响应的关键词：

speaker: {
  callAIKeywords: ["请", "帮我", "请问"],  // 触发AI回答的关键词
  wakeUpKeywords: ["召唤助手", "打开AI模式"],  // 进入AI模式的关键词
  exitKeywords: ["退出AI", "关闭助手"],  // 退出AI模式的关键词
  onEnterAI: ["你好，我是你的智能助手"],  // 进入AI模式的欢迎语
  onExitAI: ["助手已退出，再见"]  // 退出AI模式的提示语
}

多模型接入配置

MiGPT支持多种大语言模型，你可以根据需求灵活选择：

OpenAI配置

OPENAI_API_KEY=你的OpenAI密钥
OPENAI_MODEL=gpt-4o
OPENAI_BASE_URL=https://api.openai.com/v1

豆包配置

DOUBAO_API_KEY=你的豆包API密钥
DOUBAO_MODEL=Doubao-lite

其他模型支持

MiGPT还支持DeepSeek、通义千问、智谱GLM等多种模型，具体配置可参考官方文档：docs/settings.md

图：302.AI平台的多模型选择界面，展示GPT-4o、Claude-3、通义千问等主流大模型

实际应用案例

案例1：家庭学习助手

将小爱音箱改造成孩子的学习伙伴，可以回答各种学科问题，辅导作业，甚至进行外语对话练习：

// 学习助手配置示例
scenes: {
  learningAssistant: {
    enable: true,
    subjects: ["数学", "英语", "科学", "历史"],
    difficulty: "elementary",  // 根据年龄调整难度
    teachingStyle: "耐心引导"  // 教学风格
  }
}

使用方式：

"小爱同学，请帮我讲解一下勾股定理"
"小爱同学，这个英语单词怎么读？"
"小爱同学，请用简单的语言解释光合作用"

案例2：智能家居控制中心

虽然MiGPT本身不直接控制智能设备，但可以通过对话理解用户的意图，然后触发相应的智能家居场景：

// 智能家居场景配置
smartHomeScenes: {
  eveningMode: {
    trigger: ["天黑了", "我要休息了", "晚安"],
    actions: ["关闭客厅灯", "打开卧室灯", "播放轻音乐"]
  },
  morningMode: {
    trigger: ["早上好", "我起床了"],
    actions: ["打开窗帘", "播报天气", "开始煮咖啡"]
  }
}

案例3：个人健康助手

记录健康数据，提供健康建议，设置用药提醒：

healthAssistant: {
  enable: true,
  features: {
    medicationReminder: true,  // 用药提醒
    exerciseTracking: true,    // 运动记录
    sleepMonitoring: true      // 睡眠监测
  },
  dailyCheckTime: "20:00"  // 每日健康检查时间
}

常见问题排查

设备连接问题

如果小爱音箱无法连接，请按以下步骤排查：

检查小米账号信息：
- 确认使用的是小米ID（非手机号或邮箱）
- 密码是否正确
- 账号是否在米家APP中正常登录
网络环境检查：
- 确保小爱音箱和MiGPT服务器在同一局域网
- 检查防火墙设置，确保相关端口开放
- 尝试重启小爱音箱和路由器
设备名称确认：
- 在米家APP中确认小爱音箱的准确名称
- 名称中的空格和特殊字符需要正确填写

AI无响应问题

如果AI无法正常回答，请检查：

API密钥配置：
- 确认API密钥正确且有效
- 检查API服务是否可用
- 确认网络代理设置（如使用）

服务状态检查：

# 查看Docker容器状态
docker ps | grep mi-gpt

# 查看服务日志
docker logs [容器ID]

关键词配置：
- 确认唤醒关键词设置正确
- 检查是否使用了正确的触发短语
- 尝试使用默认关键词测试

语音识别不准确

如果语音识别效果不佳，可以尝试：

环境优化：
- 减少背景噪音
- 靠近音箱说话
- 在相对安静的环境中使用
发音调整：
- 语速适中，清晰发音
- 避免使用方言或口音过重
- 使用标准普通话
硬件检查：
- 清洁小爱音箱麦克风
- 检查网络连接质量
- 更新小爱音箱固件

进阶使用技巧

自定义TTS音色

MiGPT支持接入第三方TTS服务，实现音色自定义：

配置TTS服务：在.env文件中添加TTS配置：

# 豆包TTS配置
DOUBAO_TTS_API_KEY=your_tts_api_key
DOUBAO_VOICE=zh-CN-XiaoxiaoNeural  # 选择音色

音色切换关键词：在.migpt.js中配置音色切换关键词：

speaker: {
  tts: "doubao",  // 使用豆包TTS
  switchSpeakerKeywords: ["切换音色", "换一个声音", "用女声说话"]
}

连续对话优化

MiGPT支持连续对话功能，但需要正确配置：

speaker: {
  streamResponse: true,  // 启用流式响应
  exitKeepAliveAfter: 30,  // 30秒无响应后自动退出
  playingCommand: [3, 1, 1]  // 播放状态查询指令
}

内存管理配置

通过调整内存参数优化对话体验：

memory: {
  shortTerm: {
    maxMessages: 20,  // 短期记忆最大消息数
    expireTime: 3600  // 过期时间（秒）
  },
  longTerm: {
    storagePath: "./data/memory",  // 长期记忆存储路径
    syncInterval: 300  // 同步间隔（秒）
  }
}

图：302.AI平台的API配置界面，展示多模型API密钥管理功能

社区与贡献指南

项目架构理解

要更好地使用和贡献MiGPT，建议先了解其核心架构：

设备连接层：位于src/services/bot/，负责与小爱音箱通信
AI服务层：位于src/services/openai.ts，处理大模型API调用
对话管理层：位于src/services/bot/conversation.ts，管理对话流程
数据存储层：位于src/services/db/，处理对话历史和用户数据

插件开发

如果你想为MiGPT开发新功能，可以创建自定义插件：

mkdir -p src/plugins/your-plugin

实现插件类：

// src/plugins/your-plugin/index.ts
import { BasePlugin } from '../../services/plugins/base';

export class YourPlugin extends BasePlugin {
  name = 'your-plugin';
  
  async onMessage(message: string): Promise<string> {
    // 处理消息逻辑
    return `插件处理结果: ${message}`;
  }
}