夜雨聆风
把小爱音箱变成你的私人助理：一个折腾党的真实记录
----写在前面：这不是教程，是一个普通用户折腾完后的碎碎念。如果你也想让家里的小爱同学"长脑子"，或许能给你点参考。
为什么我要折腾这个？
讲真，纯属闲的淡疼。
家里的小爱音箱用了两年，除了问天气、定闹钟、放音乐，基本就吃灰了。直到某天刷到有人用它远程关电脑、查票务，我愣了一下：这玩意儿还能这么玩？
研究了一圈，发现核心是让音箱接入一个能"思考"的后端。我选的是 OpenClaw + migpt-claw 这套组合，原因很简单：开源、文档相对全、社区有人在维护。
真正动手前，先泼两盆冷水
🔹 这不是"一键傻瓜式"方案
你需要懂一点命令行、会改配置文件、能看懂报错。如果看到"终端""JSON""token"就头大，建议先找个朋友帮忙，或者等更成熟的产品。
🔹 账号安全要自己负责
配置里要填小米账号的 passToken，这玩意儿权限不小。建议单独开个小号测试，别直接用主账号。获取 token 时也注意别在公共网络操作。
我的实操过程（附踩坑记录）
01. 环境准备：别跳过这步
- 音箱：我用的红米小爱音箱 Play，便宜够用
- 主机：一台常年开机能运行OpenClaw的
- 网络：确保音箱和主机在同一局域网，不然配对会迷之失败
> 💡 小经验：先在米家 App 里给音箱改个简单名字，比如"小七"，后面配置少输错两次。
02. 安装插件：看似简单，其实有坑
按文档下载 migpt-claw 的 `.tgz` 包，终端执行安装命令。我卡在这儿半小时——如果你实在不会安装，告诉OpenClaw，让它帮你安装！
https://github.com/yuanlong/migpt-claw
插件安装命令：openclaw plugins install ./migpt-claw-1.0.0.tgz下面是踩坑记录：
**坑1**：路径问题。`openclaw plugins install ./xxx.tgz` 这个 `./` 很关键，直接写文件名可能找不到。
**坑2**：权限问题。如果提示 permission denied，试试加 `sudo`，或者检查当前用户有没有写 `~/.openclaw/` 的权限。
装完后记得在 `openclaw.json` 的 `plugins.allow` 里加上 `"migpt-claw"`，不然插件装了也白装。或者直接在web页面配置
03. 获取 passToken：最让人头大的环节
浏览器登录小米账号 → F12 打开开发者工具 → 找 Application → Cookies → 复制 `passToken`。
https://account.xiaomi.com/登录上面的网址后打开F12，在Cookie找到passToken
**但实际可能遇到**：
- 新版浏览器界面不一样，可能在"存储"标签页
- 登录时开了双重验证，cookie 可能失效快
- 复制时多选了空格，导致后续认证失败
当然你说太麻烦，有没有比较好用的方法呢？
有的有的，老铁包有的....
https://github.com/leriocn/MI-PassToken-Helper在github上有这么一个项目专门获取passToken的
> 🛠️ 我的土办法：复制完先粘贴到记事本，确认是 `V1:` 开头、中间没空格，再粘到配置文件里。
### 4. 配置 openclaw.json：耐心点，一个逗号都不能错
```json"migpt": {"enabled": true,"userId": "8620xxxxx", // 注意：是用户ID，不是手机号！"password": "你的密码","passToken": "V1:xxxxxxxx","devices": ["小爱音箱万能"], // 必须和米家App里名字一字不差"startupMessage": "您的小龙虾已上线"}```
**血泪提醒**：
- userId 去米家 App → 我的 → 点击头像 → 小米 ID 查看
- devices 里的名字大小写、空格都要完全一致，建议直接从 App 里复制
- JSON 格式很娇气，最后一个字段后面不能加逗号，用在线 JSON 校验工具过一遍
### 5. 重启 & 测试：见证奇迹的时刻
执行 `openclaw gateway restart`，等音箱播报你设的 startupMessage。
第一次成功时，我对音箱说"小爱同学，你是谁"，它先本能回复"我是小爱"，然后突然切换语气说"小龙虾收到，处理中"，接着播报 OpenClaw 返回的内容。那一刻真的有点小激动——这音箱，好像突然"活"了。
用起来之后：真香，但也有局限
让我惊喜的场景
- **语音记待办**："小爱，记一下明天下午三点开会"，自动同步到我的待办清单
- **快速查信息**：不用掏手机，直接问"乌鲁木齐明天降温吗"，音箱播报+推送到手机
- **简单自动化**：配合其他插件，说"我要睡觉了"，自动关电脑、拉窗帘（如果家里有智能设备）
### ⚠️ 目前不太行的地方
响应有延迟：语音→云端→OpenClaw→返回，大概 2-4 秒，急脾气可能受不了
复杂指令容易翻车：比如"帮我写个周报，总结本周项目进展"，返回内容可能比较泛
小米账号稳定性：偶尔会提示登录过期，需要重新获取 passToken（希望后续能优化）
给想尝试的朋友几点真心建议
1. 先在小号+备用设备上跑通，别直接上主力机，避免配置失误影响日常使用
2. 备份配置文件，每次修改前 copy 一份，改崩了能回退
3. 关注社区动态，这个项目还在迭代，GitHub 的 Issues 里常有新解法
4. 别期待"全能"，把它当成一个"能语音触发的智能中台"，合理设定预期
最后说两句
折腾完这套，我最大的感受不是"技术多牛"，而是**智能家居的主动权，其实可以握在自己手里**。
不用等厂商推送更新，不用被生态绑定，用开源工具拼出自己想要的体验。过程确实麻烦，但那种"我让设备听我指挥"的掌控感，挺上瘾的。
如果你也愿意花点时间折腾，欢迎一起交流踩坑经验。如果只想安静用现成功能，那也没问题——技术本来就是为了服务生活，不是增加负担。
📌 项目参考：
- migpt-claw: https://github.com/yuanlong/migpt-claw
- OpenClaw 文档：建议直接看 GitHub Wiki，比网上二手教程靠谱
