如何将小爱音箱改造成AI语音助手：从入门到精通的完整指南

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

MiGPT是一款能够将小爱音箱接入ChatGPT和豆包的开源项目，通过简单的配置就能让普通音箱升级为智能语音助手。本文将详细介绍如何一步步完成改造，让你的小爱音箱拥有强大的AI对话能力。

准备工作：了解你的小爱音箱型号

在开始改造前，首先需要确认你的小爱音箱型号。不同型号可能需要不同的配置参数，特别是指令代码部分。

你可以通过搜索音箱型号来获取详细规格文档，重点关注设备的服务ID（SIID）和相关指令参数。这些信息将在后续配置中用到，确保你的音箱能够正确响应AI指令。

快速开始：三步完成基础部署

1. 克隆项目代码库

首先需要将项目代码克隆到本地环境：

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

2. 安装依赖并构建项目

使用pnpm安装项目所需依赖并进行构建：

pnpm install
pnpm build

3. 启动服务

完成构建后，使用开发模式启动服务：

pnpm dev

启动成功后，你将看到终端显示服务已启动的提示信息，包括版本号和启动时间。

详细配置：连接小爱音箱与AI服务

配置音箱连接参数

项目根目录下的.migpt.js文件是核心配置文件，需要设置小爱音箱的连接信息：

• userId: 小米账号ID（不是手机号或邮箱）
• password: 小米账号密码
• did: 小爱音箱ID或名称
• ttsCommand: TTS语音合成指令
• wakeUpCommand: 唤醒指令

这些指令参数可以通过设备规格文档查询，如图中所示的play-text对应TTS指令[5, 1]，wake-up对应唤醒指令[5, 3]。

设置AI服务参数

在.env文件中配置AI服务提供商信息：

• OPENAI_API_KEY: OpenAI API密钥
• OPENAI_MODEL: 使用的模型（如gpt-4o）
• OPENAI_BASE_URL: API基础地址（可选）

你可以在API市场获取各种AI模型的访问密钥，包括OpenAI、Anthropic、Gemini等主流模型，以及国内的豆包等服务。

配置对话模式参数

还可以自定义音箱的交互模式：

• callAIKeywords: 调用AI的关键词（如"请"、"傻妞"）
• wakeUpKeywords: 唤醒AI的关键词（如"召唤傻妞"）
• exitKeywords: 退出AI模式的关键词（如"关闭傻妞"）
• streamResponse: 是否启用连续对话功能

这些配置可以在.migpt.js文件中找到并修改，根据个人喜好定制音箱的交互方式。

高级功能：优化你的AI语音助手

调整播放状态检测

如果你的音箱在播放音乐时仍会响应AI指令，可以配置播放状态检测：

playingCommand: [3, 1, 1]

这个参数对应播放控制的状态属性，确保AI只在音箱空闲时响应指令。

选择合适的AI模型

项目支持多种AI模型，你可以根据需求选择：

• GPT-4o: 综合能力强，适合复杂对话
• Claude 3 Opus: 擅长长文本处理
• Gemini 1.5 Pro: 多模态能力出色
• 国内模型: 如豆包、文心一言等，适合中文场景

扩展TTS语音引擎

默认使用小爱音箱的TTS引擎，你也可以配置第三方TTS服务：

tts: "third-party"
TTS_BASE_URL: "http://你的TTS服务地址/api"

详细配置方法可参考官方文档：docs/tts.md

常见问题解决

服务启动失败

如果提示找不到bot或数据库初始化失败，可尝试重置数据库：

pnpm run db:reset

或手动删除以下文件后重新启动：

• .mi.json
• .bot.json
• prisma/app.db
• prisma/app.db-journal

音箱连接问题

提示初始化Mi Service失败时，检查：

1. 小米账号密码是否正确
2. 网络连接是否正常
3. 音箱是否在线且已登录相同账号

连续对话功能异常

若连续对话不工作，尝试关闭流响应：

streamResponse: false

或调整自动退出时间：

exitKeepAliveAfter: 60 // 60秒无响应后退出

总结

通过MiGPT项目，只需简单几步就能将普通的小爱音箱升级为强大的AI语音助手。无论是日常对话、信息查询还是智能家居控制，改造后的音箱都能提供更智能、更个性化的服务。

项目的核心代码位于src/services/目录，包含了AI交互、数据库管理和音箱控制等关键功能。如果你想进一步定制，可以参考开发文档：docs/development.md。

现在就动手改造你的小爱音箱，体验AI语音助手带来的便利吧！

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