Open-XiaoAI Ready Pack

OH2P 刷机与接入准备手册

这份页面对应你已经准备好的本机环境。目标很简单：新买的 Xiaomi 智能音箱 Pro（OH2P） 到货后，尽量少踩坑、尽量少临时装依赖，做到插线后就能刷、刷完就能跑。

推荐机型：OH2P
当前方案：本机 Node + Rust 直跑
本地预留端口：3012 页面 / 4399 服务端

下载入口

给 MacBook 接手最推荐直接下载运行包。点下面链接就能下。

推荐下载包
`open-xiaoai-oh2p-macbook-runtime-pack.tar.gz`
精简运行包，适合直接给 MacBook 或其 agent 接手。
全量下载包
`open-xiaoai-oh2p-macbook-handoff.tar.gz`
包含更多上下文和历史文件，体积更大。

已经准备好的东西

  • Open-XiaoAI 项目已放入 `xiaomi-home` skill 目录
  • OH2P 服务端已编译成功，`open-xiaoai.node` 已产出
  • `Rust` 和 `libusb-compat` 已装好
  • OH2P `1.58.6` 的补丁固件和原版固件已下载
  • 一键刷机脚本、一键起服务脚本都已写好

当前关键路径

  • 先绑定新音箱到米家
  • 确认机型必须是 `OH2P`
  • 你这台当前版本已经查到是 `1.56.20`
  • 我已本地打出 `1.60.2` 对应补丁固件
  • 最稳方案是先把官方系统升到 `1.60.2` 再刷

最重要的风险提醒

  • 不要跨版本乱刷固件，最容易翻车
  • 刷机后如异常，可切回原版或重刷
  • 这是折腾路线，不是官方支持路线
  • 如果固件版本不符，宁可多等 5 分钟重打包，也别硬刷

目录说明

核心目录

  • `/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/examples/migpt`：服务端示例
  • `/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/packages/flash-tool`：macOS 刷机工具
  • `/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/packages/client-patch`：自定义固件打包目录
  • `/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready`：我给你整理好的即用包

ready 目录文件

  • `README.md`：总说明
  • `flash_oh2p_patched.sh`：一键刷补丁固件
  • `flash_oh2p_stock.sh`：一键刷回原版
  • `start_oh2p_server.sh`：启动本地服务端
  • `build_firmware.sh`：构建匹配版本固件
  • `print_post_flash_commands.sh`：打印音箱 SSH 后要执行的命令

到货后最短操作流程

1. 先做确认

  1. 把新音箱接电，连上 Wi‑Fi，并在米家里完成绑定。
  2. 确认设备型号确实是 `OH2P`。
  3. 确认当前系统版本是否正好为 `1.58.6`。

2. 如果版本就是 1.58.6

直接刷已经下好的官方补丁固件，不需要重新构建。 

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/flash_oh2p_patched.sh

3. 如果版本不是 1.58.6

先改 `packages/client-patch/.env` 里的 `MI_DID`，填成这台新音箱在米家里的设备名或 DID，然后构建对应版本固件。 

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/build_firmware.sh

构建产物会在 `packages/client-patch/assets` 里，拿新的 `root-patched.squashfs` 去刷。

当前这台机器的推荐路径

你现在这台新 OH2P 当前版本是 1.56.20。我已经在本机成功打出 1.60.2 对应的补丁固件，路径在： 

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/packages/client-patch/assets/mico_all_9aa0b151a_1.60.2/root-patched.squashfs

最稳做法：先在官方系统里把音箱升级到 `1.60.2`，然后运行一键刷机脚本。脚本会优先选择这个新打出来的补丁固件。

4. 刷机完成后的动作

  1. 断电重启音箱。
  2. 在路由器或米家里找到音箱的局域网 IP。
  3. 通过 SSH 登录音箱，默认密码是 `open-xiaoai`。
ssh -o HostKeyAlgorithms=+ssh-rsa root@音箱IP

5. 起服务端并让音箱连回来

先在这台 Mac 上启动服务端。脚本会自动检测本机局域网 IP，并打印出音箱里要执行的命令。 

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/start_oh2p_server.sh

然后把脚本打印出来的几条命令复制到音箱 SSH 里执行即可。

自定义唤醒词方案

这是给新 `OH2P` 单独准备的方案。老的小爱继续叫“`小爱同学`”，新的这台改成独立的中文唤醒词，避免家里两台设备抢唤醒。

当前预设词

  • `你好小秘`
  • `小秘小秘`
  • `西西西西`（对应 `CC`）

注意：当前这套轻量 KWS 只支持中文普通话，所以 `CC` 的说法这里预设成了“西西西西”。

准备好的文件

  • `ready/kws/my-keywords.txt`
  • `ready/kws/keywords.txt`
  • `ready/kws/reply.txt`
  • `ready/kws/install_custom_wakeup.sh`

安装命令

等刷机和 SSH 跑通后，直接执行下面这条命令，把自定义唤醒词和欢迎语装进音箱： 

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/kws/install_custom_wakeup.sh 音箱IP

常用命令

启动服务端

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/start_oh2p_server.sh

一键刷补丁固件

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/flash_oh2p_patched.sh

一键刷回原版

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/flash_oh2p_stock.sh

打印刷后命令

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/print_post_flash_commands.sh

安装自定义唤醒词

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/kws/install_custom_wakeup.sh 音箱IP

当前配置说明

  • 服务端配置文件：`examples/migpt/config.ts`
  • 已改成中文口播风格，更适合音箱播报
  • 当前默认后端是 OpenAI 兼容接口
  • 后续完全可以切到 OpenClaw 的 OpenAI 兼容入口
  • 当前页面端口：`3012`
  • 音箱连接服务端口：`4399`

推荐的使用心智

先把刷机和回连跑通，再考虑接 OpenClaw、切模型、做唤醒词或做智能家居动作。先求通，再求美。

故障回退

如果补丁系统有问题，可以直接刷回原版：

/Users/zizy/.openclaw/skills/xiaomi-home/open-xiaoai-oh2p/ready/flash_oh2p_stock.sh

或者切回原来的启动分区。总之，不要慌。OH2P 这条线比老款需要拆机的方案要友好得多。