3步让小爱音箱变身AI语音助手：MiGPT完整配置指南

你是否曾经对着家里的小爱音箱提问，得到的却是"抱歉，我还没学会这个功能"的尴尬回复？是否羡慕过那些能与ChatGPT自然对话的智能助手，却苦于没有合适的硬件？现在，通过MiGPT项目，你只需简单三步就能将普通的小爱音箱升级为真正的AI语音助手，让它从"人工智障"变成你的智能伙伴。MiGPT是一个开源项目，专门将小爱音箱接入ChatGPT、豆包等大语言模型，赋予其真正的理解和对话能力。## 🤔

霍美予Mabel

232人浏览 · 2026-05-25 09:02:33

霍美予Mabel · 2026-05-25 09:02:33 发布

3步让小爱音箱变身AI语音助手：MiGPT完整配置指南

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

🤔 传统小爱音箱 vs MiGPT：从机械应答到智能对话

传统的智能音箱大多只能执行预设的指令——"开灯"、"关空调"、"播放音乐"。它们缺乏真正的理解能力，无法进行自然语言对话，更别提记住你的偏好和习惯了。而通过MiGPT改造后的小爱音箱，将拥有以下变革性能力：

传统小爱音箱的局限性：

只能识别固定指令模式
无法理解上下文和语境
每次对话都是独立的，没有记忆
回答内容局限于预设知识库
无法进行角色扮演和个性化互动

MiGPT带来的变革：

✅ 真正的自然语言理解能力
✅ 支持连续对话和上下文记忆
✅ 个性化角色扮演（老师、朋友、助手等）
✅ 长期记忆功能，越用越懂你
✅ 支持多种大语言模型切换
✅ 流式响应，对话更自然流畅

📋 准备工作：你的智能升级清单

在开始配置之前，请确保你准备好了以下所有物品：

硬件设备要求

小爱音箱（推荐以下型号）：
- 🏆 首选推荐：小爱音箱Pro（型号LX06）——完美支持连续对话
- ✅ 良好支持：小米AI音箱第二代（型号L15A）——支持连续对话
- ✅ 基本支持：小爱音箱Play增强版（型号L05C）
- ❌ 暂不支持：小米小爱音箱HD（型号SM4）、小度音箱、天猫精灵等
电脑或服务器：用于运行MiGPT服务（Windows/Mac/Linux均可）
稳定的网络环境：确保小爱音箱和运行MiGPT的设备在同一局域网

软件和账号准备

小米账号：确保你有小米账号并已绑定小爱音箱
AI模型API密钥：任选其一即可：
- OpenAI API密钥（ChatGPT系列）
- 通义千问API密钥
- 豆包API密钥
- 其他兼容OpenAI API的大模型
Docker环境（推荐新手）或Node.js环境（适合开发者）
项目文件：从代码仓库获取MiGPT源代码

获取小米ID的步骤

小米ID是配置的关键，它不是手机号也不是邮箱，需要按以下步骤获取：

打开米家APP，进入"我的"页面
点击右上角设置图标
选择"个人信息"
在页面中找到"小米ID"（通常是一串数字）
记下这个ID，后续配置会用到

🚀 三步配置：从小白到AI助手专家

第一步：获取并准备项目文件

首先，克隆MiGPT项目到本地：

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

然后复制配置文件模板：

# 复制配置文件模板
cp .migpt.example.js .migpt.js
cp .env.example .env

图：在米家APP中查询小爱音箱型号信息，确保设备兼容性

第二步：配置核心参数

现在打开两个配置文件进行编辑：

1. 设备配置文件 (.migpt.js)

这个文件定义了小爱音箱的连接参数和交互设置：

// 小爱音箱扮演角色的简介
const botProfile = `
性别：女
性格：乖巧可爱
爱好：喜欢搞怪，爱吃醋。
`.trim();

// 小爱音箱主人（你）的简介
const masterProfile = `
性别：男
性格：善良正直
其他：总是舍己为人，是傻妞的主人。
`.trim();

export default {
  bot: {
    name: "傻妞",          // 你可以自定义助手的名字
    profile: botProfile,   // 助手的性格描述
  },
  master: {
    name: "陆小千",        // 你的名字
    profile: masterProfile,
  },
  speaker: {
    // 🏠 账号基本信息
    userId: "987654321",   // 你的小米ID（不是手机号）
    password: "123456",    // 小米账号密码
    did: "小爱音箱Pro",    // 小爱音箱在米家中的名称

    // 💡 唤醒词与提示语
    callAIKeywords: ["请", "你", "傻妞"],  // 触发AI回复的关键词
    wakeUpKeywords: ["打开", "进入", "召唤"], // 进入AI模式的关键词
    exitKeywords: ["关闭", "退出", "再见"],   // 退出AI模式的关键词
    
    // 🧩 MIoT 设备指令
    ttsCommand: [5, 1],    // 文本转语音指令
    wakeUpCommand: [5, 3], // 设备唤醒指令
  },
};

2. 环境配置文件 (.env)

这个文件配置AI模型参数：

# OpenAI（也支持通义千问、MoonShot、DeepSeek等模型）
OPENAI_MODEL=gpt-4o-mini
OPENAI_API_KEY=sk-proj-你的API密钥

# 你的大模型服务接口（可选）
# OPENAI_BASE_URL=https://api.openai.com/v1

第三步：选择部署方式启动服务

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

如果你不熟悉Node.js环境，Docker是最简单的选择：

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

Docker部署优势：

🎯 无需安装Node.js环境
⚡ 一键启动，配置简单
🛡️ 环境隔离，避免冲突
🔄 更新方便，维护简单

方案B：Node.js源码部署（开发者推荐）

如果你希望进行二次开发或有Node.js基础：

# 安装依赖
pnpm install
pnpm db:gen

# 开发模式启动
pnpm dev

源码部署优势：

🔧 便于自定义修改
🐛 更好的调试体验
🔥 支持热重载开发
📚 深入学习项目架构

图：MiGPT项目成功启动后的终端界面，显示服务已就绪

🎯 开始使用：三种方式召唤你的AI助手

配置完成后，你就可以通过以下方式与小爱音箱进行智能对话了：

方式一：标准提问模式

唤醒词：小爱同学，请xxx 示例：小爱同学，请帮我解释一下量子力学的基本原理

方式二：直接对话模式

唤醒词：小爱同学，你xxx 示例：小爱同学，你今天心情怎么样？

方式三：角色召唤模式

唤醒词：小爱同学，召唤xxx 示例：小爱同学，召唤英语老师

实际对话示例

你：小爱同学，请帮我制定一个健身计划
AI助手：好的！根据你的情况，我为你制定了一个为期4周的健身计划...

你：小爱同学，你觉得这个计划可行吗？
AI助手：当然可行！这个计划考虑了循序渐进的原则...

你：小爱同学，如果我坚持不下来怎么办？
AI助手：别担心，我们可以调整计划，最重要的是保持运动的习惯...

图：MiGPT设备指令对应表，展示如何将自然语言转换为设备控制命令

🔧 高级配置：打造专属的智能助手

启用智能记忆系统

让AI助手记住你们的对话，建立更亲密的关系：

// 在.migpt.js中添加记忆配置
memory: {
  enable: true,
  longTerm: {
    maxTokens: 2000  // 长期记忆容量，越大记住的内容越多
  },
  shortTerm: {
    maxMessages: 10   // 短期记忆消息数量
  }
}

自定义TTS音色和响应速度

如果觉得AI回答太慢或音色不满意，可以这样优化：

speaker: {
  tts: "xiaoai",           // 使用小爱自带TTS引擎
  onAIAsking: [],          // 关闭AI开始回答时的提示语
  onAIReplied: [],         // 关闭AI结束回答时的提示语
  
  // 连续对话优化
  streamResponse: true,    // 启用流式响应
  checkInterval: 800,      // 降低检测间隔，减少停顿感
  checkTTSStatusAfter: 2,  // 调整检测时机
}

支持多种AI模型切换

除了OpenAI，MiGPT还支持多种大语言模型：

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

# DeepSeek配置示例
OPENAI_BASE_URL=https://api.deepseek.com
OPENAI_MODEL=deepseek-chat
OPENAI_API_KEY=你的DeepSeek API密钥

💡 实用场景：解锁AI助手的无限可能

学习助手模式

英语学习："小爱同学，你现在是我的英语老师"
编程辅导："帮我解释一下JavaScript的闭包概念"
知识问答："黑洞是怎么形成的？"

生活助手模式

日程管理："提醒我明天下午3点开会"
创意写作："帮我写一封感谢信"
娱乐互动："讲一个有趣的睡前故事"

工作助手模式

会议记录："总结刚才讨论的要点"
邮件草拟："帮我写一封工作邮件"
数据分析："解释这个数据图表的意义"

图：MiGPT播放控制属性配置，实现精细化的设备状态管理

🔍 故障排查：常见问题与解决方案

问题一：小爱音箱无响应

排查步骤：

检查小米账号密码是否正确
确认小爱音箱已联网并在线
重启小爱音箱和MiGPT服务
查看服务日志确认连接状态

解决方案：

# 查看Docker容器日志
docker logs <容器ID>

# 查看服务状态
docker ps | grep mi-gpt

问题二：AI服务异常

排查步骤：

验证API密钥是否有效
检查网络连接是否正常
查看.env文件配置是否正确
确认AI模型服务是否可用

解决方案：

更换API密钥
检查网络代理设置
尝试不同的AI模型

问题三：语音断断续续

排查步骤：

检查网络带宽是否充足
确认流式响应是否开启
查看设备播放状态检测设置

解决方案：

// 调整响应参数
streamResponse: true,
checkInterval: 800,      // 降低检测间隔
checkTTSStatusAfter: 2,  // 调整检测时机

🎓 最佳实践：提升使用体验的5个技巧

技巧1：个性化角色设置

为你的AI助手设置独特的性格和背景故事，让它成为你的专属伙伴：

const botProfile = `
姓名：小智
年龄：25岁
职业：AI研究助理
性格：热情、耐心、知识渊博
特长：编程、科学、历史
口头禅："这个问题很有趣！让我想想..."
`.trim();

技巧2：优化唤醒体验

设置更自然的唤醒方式，让交互更加流畅：

callAIKeywords: ["请", "你", "小智", "帮我"],
wakeUpKeywords: ["打开", "进入", "召唤", "启动"],
exitKeywords: ["关闭", "退出", "再见", "休息"],

技巧3：利用记忆功能

开启长期记忆，让AI助手记住你的偏好和习惯：

memory: {
  enable: true,
  longTerm: {
    maxTokens: 3000,      // 增加记忆容量
    importanceThreshold: 0.7  // 重要信息记忆阈值
  }
}

技巧4：定期备份配置

避免配置丢失，养成备份习惯：

# 备份配置文件
cp .migpt.js .migpt.js.backup
cp .env .env.backup

技巧5：关注项目更新

及时获取新功能和修复：

# 更新项目
git pull origin main
# 重启服务
docker restart <容器ID>

📚 深入学习：官方文档资源

想要更深入地了解MiGPT的各项功能？以下官方文档资源可以帮助你：

参数设置文档：docs/settings.md - 详细的所有配置参数说明
常见问题解答：docs/faq.md - 大多数问题的解决方案
工作原理说明：docs/how-it-works.md - 了解MiGPT的内部机制
TTS配置指南：docs/tts.md - 自定义语音合成设置
开发指南：docs/development.md - 二次开发和定制指南
更新日志：docs/changelog.md - 查看最新功能更新

🎉 总结：开启智能家居新纪元

通过以上三个简单步骤，你已经成功将普通的小爱音箱升级为智能AI语音助手。MiGPT不仅让你的智能音箱拥有了真正的对话能力，更开启了智能家居交互的新可能。

你的收获清单：

✅ 学会了选择合适的设备型号和准备必要条件
✅ 掌握了两种部署方式：Docker一键部署和Node.js源码部署
✅ 理解了核心配置文件的各项参数含义
✅ 知道了三种召唤AI助手的方式和实际应用场景
✅ 学会了常见问题的排查方法和优化技巧
✅ 探索了个性化配置和高级功能的使用

立即行动：

准备好你的小爱音箱和电脑
按照本文的三步配置指南操作
开始体验真正的智能语音交互
根据个人需求进行个性化定制

记住，最好的学习方式就是动手实践。现在就开始你的MiGPT之旅，让你的小爱音箱从简单的指令执行器，变成一个能理解你、陪伴你、帮助你的智能伙伴。智能家居的未来，就从今天开始！

温馨提示： 使用过程中如遇到问题，可以先查阅官方文档：docs/faq.md，大多数常见问题都能在那里找到答案。祝你使用愉快！

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

AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

从 curl 通到项目跑通：DeepSeek API 接入的 5 个坑

AI Agent技术社区

DeepSeek总结的展望 Postgres 19：查询提示

文章摘要： Postgres 19 将引入查询提示功能，通过新增的 pg_plan_advice 和 pg_stash_advice 模块实现。这一功能结束了 Postgres 社区长期以来的争论，为 DBA 提供了优化查询的灵活工具。pg_plan_advice 允许通过 GUC 或独立存储区设置建议，约束而非替代规划器的决策，确保错误建议能优雅降级。pg_stash_advice 则支持将建议

AI Agent技术社区

DeepSeek总结的使用 Docker 对 PostgreSQL 进行 Beta 测试

本文介绍了如何使用Docker容器测试PostgreSQL 19 Beta 1版本。作者详细说明了通过Docker构建预发布镜像的步骤，包括获取适合操作系统的Docker版本和使用docker buildx命令构建特定版本。文中演示了启动容器、连接数据库以及测试PostgreSQL 19的新功能，如pg_stat_lock视图、pg_plan_advice扩展和pg_stat_statements