EEPW论坛

【RaspberryPi5开发板方案创意赛】HomeAssistant智能家居系统--安装HAOS、HACS和米家集成-电子产品世界论坛

【RaspberryPi5开发板方案创意赛】HomeAssistant智能家居系统--添加语音助手-电子产品世界论坛

【RaspberryPi5开发板方案创意赛】HomeAssistant智能家居系统--部署AI对话代理-电子产品世界论坛

前面几篇，我在树莓派5上安装了 Home Assistant 系统，并安装了米家集成，配置了 Home Assistant Cloud、AI对话代理，将ESP32-S3-BOX-3作为语音助手终端，实现了通过 “Okay Nabu” 英文唤醒词实现语音对话、设备控制等功能。但英文唤醒词使用体验确实不好，本篇作为成果篇，将介绍如何在 Home Assistant 中部署 openWakeWord，实现 小智、小爱 等中文唤醒词的使用。

1、唤醒词简介

Home Assistant 为语音助手提供了两种唤醒词实现方案，核心差异如下：

① microWakeWord（On Device）

这个方案是由Kevin Ahrendt开发，将训练好的唤醒词模型直接集成到 ESP32 设备固件中，无需依赖 Home Assistant 服务器，因此唤醒响应速度快、准确率高（如我们此前使用的 “Okay Nabu”）。但该方案的缺点是模型数量少，暂无中文模型，且自定义训练难度较高。

② openWakeWord（In Home Assistant）

这个方案是基于openWakeWord的在线语音唤醒，通过 Wyoming 协议将 openWakeWord 集成到 Home Assistant 中，所有语音助手终端均可共用该唤醒词。其优势是支持多语言，可轻松实现中文唤醒词；缺点是唤醒响应速度略慢于 microWakeWord（需依赖服务器处理）。

2、搭建中文唤醒词

需要通过 4 个核心步骤完成 openWakeWord 中文唤醒词的部署，操作流程如下：

① 安装openWakeWord加载项

进入Home Assistant，在设置 → 加载项 → 加载项商店，搜索openWakeWord，找到对应的加载项后点击下载并完成安装。安装完成后，在加载项列表中找到 openWakeWord 并启用该服务。

② 集成 Wyoming Protocol 设备

返回Home Assistant，在设置 → 设备与服务，系统会自动发现Wyoming Protocol 集成设备，其中已包含openWakeWord实体，直接确认添加即可。

③ 下载中文唤醒词模型

使用加载项Advanced SSH & Web Terminal，执行以下命令，将中文唤醒词模型下载到指定目录：

# 创建openWakeWord模型存储目录
mkdir -p /share/openwakeword
# 设置目录权限，确保服务可读取
chmod 775 /share/openwakeword
# 下载“小智”“小爱”中文唤醒词模型
wget -P /share/openwakeword \
  https://gitee.com/py2012/home-assistant-wakewords-collection/raw/main/zh/xiao_zhi.tflite \
  https://gitee.com/py2012/home-assistant-wakewords-collection/raw/main/zh/xiao_ai.tflite

④ 为语音助手启用中文唤醒词

重启Home Assistant后，在设置 → 语音助手，打开需要配置中文唤醒词的语音助手。初始状态下，语音助手配置窗口无唤醒词设置项：

点击配置页面右上角的三个点图标，选择添加流媒体唤醒词：

此时配置窗口底部会新增流媒体唤醒词引擎选项。引擎选择openWakeWord，唤醒词选择已下载的中文唤醒词（如xiao Zhi）。

更新语音助手，完成中文唤醒词配置。

3、中文唤醒词测试

进入 Home Assistant ，在设置 → 设备与服务 → ESPHome，找到对应的 ESPHOME 设备（如 ESP3-S3-BOX-3），在配置页面将唤醒词引擎改为In Home Assistant。

配置完成后，即可使用 “小智” 唤醒语音助手终端，可正常进行语音对话、设备控制等操作。实际测试下来，“小智”唤醒的灵敏度和准确率表现出色，效果已经非常接近 Okay Nabu ；相比之下，“小爱”唤醒词的触发成功率略低，需要在相对安静的环境下、用更清晰的发音才能稳定唤醒。