全屋语音播报

技能简介

Announcer 通过 Airfoil 将文字转为语音，经 AirPlay 音箱实现全屋广播。集成 ElevenLabs 高质量语音合成，支持可选提示音与指定房间播放。

业务背景

解决家庭或办公场景中信息触达不及时的问题。通过现有AirPlay音箱网络，将重要通知、提醒或状态播报即时送达指定区域，无需额外采购硬件。ElevenLabs合成语音自然度高，避免机械感，提升信息接收体验。

落地案例：早晨出门前，系统自动播报当日天气与日程安排；快递到达时，门厅音箱即时语音提示取件；晚间书房工作时，仅向该区域播报专注时段开始，避免打扰家人休息。物业或小型办公场景亦可用于紧急通知分区广播。

能做什么

• 向全部或指定 AirPlay 音箱发送语音通知
• 调用 ElevenLabs API 生成自然语音（opus 转立体声 MP3）
• 播放前附加提示音，也可跳过
• 播完后自动断开音箱连接

使用说明

安装前提

1. macOS 系统，安装 Python3、ffmpeg
2. 安装 Airfoil 应用并配置 AirPlay 音箱
3. 获取 ElevenLabs API Key，配置环境变量 ELEVENLABS_API_KEY
4. 依赖技能：elevenlabs

基础用法

# 向所有已配置音箱广播
python3 skills/announcer/scripts/announce.py "Dinner is ready!"

# 仅向指定音箱广播
python3 skills/announcer/scripts/announce.py "Wake up!" --speakers "Kids Room"

# 跳过提示音
python3 skills/announcer/scripts/announce.py "Quick note" --no-gong

用户配置文件路径：~/clawd/announcer/config.json（含音箱列表、音色、音频参数）。

输入与输出

见下方输入与输出表格。

风险提示

• 需持续联网调用 ElevenLabs API，网络中断会导致合成失败
• Airfoil 为 macOS 独占应用，无法跨平台运行
• API Key 泄露可能导致额度被盗用
• 夜间高音量广播可能干扰休息，建议配合时间判断逻辑

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/odrobnik/announcer/SKILL.md
来源类型：GitHub 仓库