直接分享一套已排雷验证的完整流程，从豆包API申请到MiGPT部署再到正式使用，按步骤操作即可让小爱音箱Pro顺利调用豆包全部AI能力。

一、准备工作（必须完成）

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

豆包API的申请入口不在豆包App内，需前往火山引擎方舟平台。按以下步骤操作即可。

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. 执行以下命令，一键启用WSL2和虚拟机平台：
   wsl --install
3. 命令执行完毕后提示“需要重启电脑”，直接点击“重启”——重启后系统会自动下载Ubuntu子系统，无需手动操作。
4. 重启后等待Ubuntu子系统安装完成。首次启动可能会弹出设置Ubuntu用户名/密码的窗口，随意设置即可，不影响Docker使用。
5. 验证WSL2是否安装成功：重新打开终端，执行：
   wsl --list --verbose
   ✅ 正常输出：会显示“Ubuntu”，且“VERSION”列显示“2”（而非1）。

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 是否安装并正常运行（三步必查）

安装完成后，按以下步骤验证。全部通过即为成功。

步骤 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:SKDOUBAO_MODEL=接入点ID# 如 ep-xxxxxxxxxxxxxxDOUBAO_BASE_URL=https://ark.cn-beijing.volces.com/api/v3# 固定值DOUBAO_REGION=cn-beijing# 与接入点地域一致# 其他设置（可选）BOT_NAME=豆包# 回答时的称呼TTS_TYPE=xiaomi# 使用小爱原生TTS，也可改为doubao使用豆包音色

3. 启动 MiGPT 服务

打开终端/命令提示符，执行以下命令（将本地路径替换为你自己migpt文件夹的实际路径）：

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

具体操作可参考下图：

查看所有容器：

4. 验证部署

• 访问https://localhost:3000，看到MiGPT界面即表示部署成功。
• 检查日志：执行docker logs mi-gpt，若无报错即可直接使用。

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

1. 基础用法

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

2. 进阶玩法

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

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