让“小爱音箱PRO”智能起来：接入豆包AI

下面提供从 0 到 1 的完整流程，包含豆包 API 申请、MiGPT 部署、配置与使用，确保你能顺利让小爱音箱 Pro 用上豆包的强大能力。

一、准备工作（必做）

二、申请豆包 API 密钥（关键步骤）

豆包 API 需通过火山引擎方舟平台申请，以下是详细步骤：

1. 注册与实名认证

1. 访问火山引擎官网：https://www.volcengine.com/
2. 注册账号并完成实名认证（个人 / 企业均可）
3. 登录后进入方舟大模型平台

2. 创建 API 密钥与推理接入点

1. 进入控制台 → API 密钥管理 → 点击 "创建密钥"，保存Access Key ID和Secret Access Key
2. 进入在线推理 → 创建推理接入点：
   • 名称：自定义（如 "小爱音箱豆包"）
   • 模型选择：豆包系列（推荐 Doubao-seed-1.6-flash，响应快）
   • 地域：选择cn-beijing（国内延迟低）
3. 等待状态变为 "运行中"，记录接入点 ID（格式：ep-xxxxxxxxxxxxxx）

三、部署 MiGPT（推荐 Docker 方式，零门槛）

1. 安装 Docker

• Windows/macOS：下载Docker Desktop并安装
• Linux：执行sudo apt-get install docker.io（Ubuntu）

1.1、安装前必做：检查前置条件（避免安装失败）

Docker Desktop 在 Windows 上依赖WSL2（适用于 Linux 的 Windows 子系统），必须先满足以下条件：

步骤 1：开启 WSL2（核心依赖，必做）

1. 按下Win+X，选择「Windows 终端（管理员）」（注意必须是管理员权限）；
2. 命令执行后会提示「需要重启电脑」，点击「重启」（重启后会自动下载 Ubuntu 子系统，无需手动操作）；
3. 重启后等待 Ubuntu 子系统安装完成（首次开机可能会弹窗设置 Ubuntu 用户名 / 密码，随便设置即可，不影响 Docker 使用）；

验证 WSL2 是否安装成功：重新打开终端，执行：

wsl --list --verbose 

✅ 正常输出：能看到「Ubuntu」且「VERSION」列显示「2」（不是 1）。

执行以下命令，一键开启 WSL2 和虚拟机平台：

wsl --install 

1.2、下载并安装 Docker Desktop

步骤 1：下载安装包

1. 访问 Docker 官方下载页：https://www.docker.com/products/docker-desktop/
2. 点击「Download for Windows」，下载安装包（约 500MB，耐心等待）；
   • 若官网下载慢，可改用国内镜像：https://mirrors.aliyun.com/docker-toolbox/windows/docker-desktop/

步骤 2：安装 Docker（关键选项别错）

1. 双击下载的Docker Desktop Installer.exe，开始安装；
2. 安装界面勾选以下选项（重中之重）：
   • ✅ Use WSL 2 instead of Hyper-V（优先用 WSL2，避免 Hyper-V 冲突）；
   • ✅ Add shortcut to desktop（桌面创建快捷方式，方便后续打开）；
3. 点击「OK」开始安装，等待 2-5 分钟（安装过程会自动配置环境变量）；
4. 安装完成后，勾选「Start Docker Desktop」，点击「Finish」。

步骤 3：首次启动 Docker

1. 启动后会弹出「Service Agreement」（服务协议），点击「Accept」；
2. 等待 Docker 初始化（桌面右下角会出现「鲸鱼图标」，图标无红色叉号即正常）；
   • 首次启动可能会提示「WSL2 is not installed」，说明之前 WSL2 没装成功，回到第一步重新执行wsl --install。

1.3、验证 Docker 是否安装并正常运行（三步必查）

安装完成后，按以下步骤验证，全部通过即说明安装 OK：

步骤 1：检查 Docker 版本

打开「Windows 终端」（普通权限即可），执行：

docker --version 

✅ 正常输出示例（版本号可能不同）：

Docker version 25.0.3, build 4debf41 

❌ 异常：提示「'docker' 不是内部或外部命令」→ 重启电脑（让环境变量生效），或重新安装 Docker。

步骤 2：检查 Docker 服务状态

• 看桌面右下角的「鲸鱼图标」：
  • 右键图标 → 选择「Settings」能正常打开 → 服务运行中；
  • 若图标有红色叉号 → 右键选择「Restart Docker」重启。

步骤 3：运行测试容器（最终验证）

执行 Docker 官方的「hello-world」测试容器，这是最权威的验证方式：

docker run hello-world 

✅ 正常输出（关键看最后一行）：

Hello from Docker! This message shows that your installation appears to be working correctly. 

❌ 异常：提示「pull access denied」→ 网络问题，后续配置国内镜像源即可

2. 创建配置文件

在电脑上新建migpt文件夹，创建以下两个文件：

（1）.migpt.js（小爱音箱配置）

module.exports = { speaker: { userId: "你的小米账号", // 必须修改 password: "你的小米密码", // 必须修改 did: "小爱音箱Pro", // 必须与米家App设备名称一致 ttsCommand: [5, 1], // 小爱音箱Pro专用参数，不可改 wakeUpCommand: [5, 3], // 小爱音箱Pro专用参数，不可改 monitorCommand: [3, 1, 1], // 小爱音箱Pro专用参数，不可改 callAIKeywords: ["豆包", "请", "你"] // 触发豆包AI的关键词 } } 

（2）.env（豆包 API 配置）

# 豆包配置 DOUBAO_API_KEY=你的Access Key ID:Secret Access Key # 格式如AK:SK DOUBAO_MODEL=接入点ID # 如ep-xxxxxxxxxxxxxx DOUBAO_BASE_URL=https://ark.cn-beijing.volces.com/api/v3 # 固定值 DOUBAO_REGION=cn-beijing # 与接入点地域一致 # 其他设置（可选） BOT_NAME=豆包 # 回答时的称呼 TTS_TYPE=xiaomi # 使用小爱原生TTS，也可改为doubao使用豆包音色 

3. 启动 MiGPT 服务

打开终端 / 命令提示符，执行以下命令（替换本地路径）：

docker run -d \ -v /本地migpt文件夹路径:/app/config \ -p 3000:3000 \ --name mi-gpt \ idootop/mi-gpt:latest 

具体如下：

查看所有容器：

4. 验证部署

• 访问http://localhost:3000，看到 MiGPT 界面即部署成功
• 检查日志：docker logs mi-gpt，无报错即可使用

四、使用豆包 AI 功能（超简单）

1. 基础使用

1. 对小爱音箱说：" 小爱同学，豆包，什么是人工智能？"（关键词触发）
2. 或：" 小爱同学，请帮我写一首关于春天的诗 "
3. MiGPT 会自动拦截问题，调用豆包生成回答，通过音箱播报

2. 高级玩法

五、常见问题与解决方案（避坑指南）

六、两种接入方式对比（官方 vs 豆包）