open-xiaoai/examples/kws/README.md

Open-XiaoAI x Sherpa-ONNX

Important

本教程仅适用于 小爱音箱 Pro（LX06） 和 Xiaomi 智能音箱 Pro（OH2P）

小爱音箱自定义唤醒词，基于 sherpa-onnx。

刷机

首先按照 open-xiaoai 里的教程将小爱音箱刷机，然后 SSH 连接到小爱音箱。

安装脚本

在小爱音箱上安装启动脚本，然后重启小爱音响。

# 下载到 /data/init.sh 开机时自启动
curl -L -o /data/init.sh https://gitee.com/idootop/artifacts/releases/download/open-xiaoai-kws/init.sh

设置唤醒词

在你的电脑上克隆本项目，然后修改 my-keywords.txt 文件里的唤醒词。注意：

• 仅支持中文唤醒词
• 支持多个唤醒词，每行一个

运行以下命令，更新 keywords.txt 配置文件：

# 你可能需要先安装 uv 👉 https://github.com/astral-sh/uv
uv run keywords.py --tokens tokens.txt --output keywords.txt --text my-keywords.txt

然后将你电脑上的 keywords.txt 复制到小爱音箱 /data/open-xiaoai/kws/keywords.txt，重启小爱音箱即可。

设置欢迎语

你也可以设置自定义唤醒词唤醒后的提示语。首先新建一个 reply.txt 文件：

主人你好，请问有什么吩咐？
https://example.com/music.wav
file:///usr/share/sound-vendor/AiNiRobot/wakeup_ei_01.wav

注意：

• 每行一句欢迎语
• 支持文字和音频链接
• 多条欢迎语会随机选择一句播放
• 默认欢迎语与小爱同学一致：“哎”、“在”

然后将你电脑上的 reply.txt复制到小爱音箱 /data/open-xiaoai/kws/reply.txt，重启小爱音箱即可。