什么是Pi Speaker
Pi Speaker 是一个专为树莓派（或网关主机）设计的本地音频输出工具，主要用于通过设备的默认扬声器播放文本转语音（TTS）内容或音频文件。它适用于需要在 Pi 设备上实现语音播报、设置闹钟提醒、播放新闻摘要等场景，特别适合搭配 OpenClaw 网关系统使用。当用户发出类似“在 Pi 上说…”、“播报 X”或“用声音提醒我 Y”等指令时，该工具能够调用 TTS 生成语音文件，并通过系统命令直接播放到连接的蓝牙音箱或其他音频输出设备。整个流程无需复杂配置，只需两步即可完成：首先生成音频文件，再执行本地播放命令。需要注意的是，所有操作均在网关主机上运行，且必须确保默认音频输出已正确设置，例如蓝牙音箱已成功连接并被 pactl 或 wpctl 识别为当前 sink。
核心功能特点
- 基于树莓派或任意支持音频输出的网关主机，利用本地默认音频输出进行语音播放
- 通过调用 TTS 工具生成语音文件，再使用 pw-play、paplay 或自定义脚本实现本地播放
- 无需专用 CLI 命令，仅需组合使用 tts 和 exec 两个工具完成完整流程
- 生成的音频文件存储于主机临时目录，播放必须由同一主机上的 bash 环境执行
- 支持短文本播报，避免因长句导致 TTS 生成超时或请求失败
适用场景
Pi Speaker 最典型的应用场景是智能家居系统中的语音交互环节。例如，当用户在家庭自动化平台中设置一个定时任务，希望在每天早上7点听到天气播报时，就可以通过 Pi Speaker 将 TTS 生成的语音文件播放到已连接的蓝牙音箱上。另一个常见用途是在教育类项目中，让树莓派扮演智能助手角色，回答学生提问后立即用语音反馈结果。此外，在安防监控系统中，一旦检测到异常事件，可通过 Pi Speaker 发出语音警报，通知相关人员注意查看摄像头画面。由于该工具完全依赖本地音频栈（如 PipeWire 或 PulseAudio），因此响应速度快、延迟低，且不依赖云端服务，非常适合对隐私和实时性要求较高的离线环境。只要网关主机具备可用的音频会话和正确的默认输出设备，即可稳定运行各类语音播报任务。