介绍
# Sound FX (ElevenLabs)
## 概述 使用 ElevenLabs SFX API 从文本提示生成音效。默认输出为 MP3；请将其转换为 .ogg/opus 以便在 WhatsApp 移动端播放。
## 快速开始 1) 设置 API 密钥： - `ELEVENLABS_API_KEY`（首选）或 `XI_API_KEY` - 或者在 `~/.clawdbot/clawdbot.json` 中设置 `skills."sound-fx".env.ELEVENLABS_API_KEY`
2) 生成 SFX (MP3)： ```bash scripts/generate_sfx.sh --text "short audience applause" --out "/tmp/applause.mp3" --duration 1.2 ```
3) 转换为 WhatsApp 兼容的 .ogg/opus（如需要）： ```bash ffmpeg -y -i /tmp/applause.mp3 -c:a libopus -b:a 48k /tmp/applause.ogg ```
## 脚本：scripts/generate_sfx.sh **用法** ```bash scripts/generate_sfx.sh --text "canned laughter" --out "/tmp/laugh.mp3" --duration 1.5 ```
**说明** - 使用 `POST https://api.elevenlabs.io/v1/sound-generation` - 支持可选参数 `--duration`（0.5–30秒）。如省略，时长为自动。 - 成功时打印 `MEDIA: <path>` 以便自动附加。
## 示例 - 掌声：`"short audience applause"` - 笑声：`"canned audience laughter"` - 嗖声：`"fast whoosh"` - 环境音：`"soft rain ambience"`