mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-12 07:20:45 +00:00
04e103d10e
* Terminal: measure grapheme display width * Tests: cover grapheme terminal width * Terminal: wrap table cells by grapheme width * Tests: cover emoji table alignment * Terminal: refine table wrapping and width handling * Terminal: stop shrinking CLI tables by one column * Skills: use Terminal-safe emoji in list output * Changelog: note terminal skills table fixes * Skills: normalize emoji presentation across outputs * Terminal: consume unsupported escape bytes in tables
88 lines
2.2 KiB
Markdown
88 lines
2.2 KiB
Markdown
---
|
|
name: sag
|
|
description: ElevenLabs text-to-speech with mac-style say UX.
|
|
homepage: https://sag.sh
|
|
metadata:
|
|
{
|
|
"openclaw":
|
|
{
|
|
"emoji": "🔊",
|
|
"requires": { "bins": ["sag"], "env": ["ELEVENLABS_API_KEY"] },
|
|
"primaryEnv": "ELEVENLABS_API_KEY",
|
|
"install":
|
|
[
|
|
{
|
|
"id": "brew",
|
|
"kind": "brew",
|
|
"formula": "steipete/tap/sag",
|
|
"bins": ["sag"],
|
|
"label": "Install sag (brew)",
|
|
},
|
|
],
|
|
},
|
|
}
|
|
---
|
|
|
|
# sag
|
|
|
|
Use `sag` for ElevenLabs TTS with local playback.
|
|
|
|
API key (required)
|
|
|
|
- `ELEVENLABS_API_KEY` (preferred)
|
|
- `SAG_API_KEY` also supported by the CLI
|
|
|
|
Quick start
|
|
|
|
- `sag "Hello there"`
|
|
- `sag speak -v "Roger" "Hello"`
|
|
- `sag voices`
|
|
- `sag prompting` (model-specific tips)
|
|
|
|
Model notes
|
|
|
|
- Default: `eleven_v3` (expressive)
|
|
- Stable: `eleven_multilingual_v2`
|
|
- Fast: `eleven_flash_v2_5`
|
|
|
|
Pronunciation + delivery rules
|
|
|
|
- First fix: respell (e.g. "key-note"), add hyphens, adjust casing.
|
|
- Numbers/units/URLs: `--normalize auto` (or `off` if it harms names).
|
|
- Language bias: `--lang en|de|fr|...` to guide normalization.
|
|
- v3: SSML `<break>` not supported; use `[pause]`, `[short pause]`, `[long pause]`.
|
|
- v2/v2.5: SSML `<break time="1.5s" />` supported; `<phoneme>` not exposed in `sag`.
|
|
|
|
v3 audio tags (put at the entrance of a line)
|
|
|
|
- `[whispers]`, `[shouts]`, `[sings]`
|
|
- `[laughs]`, `[starts laughing]`, `[sighs]`, `[exhales]`
|
|
- `[sarcastic]`, `[curious]`, `[excited]`, `[crying]`, `[mischievously]`
|
|
- Example: `sag "[whispers] keep this quiet. [short pause] ok?"`
|
|
|
|
Voice defaults
|
|
|
|
- `ELEVENLABS_VOICE_ID` or `SAG_VOICE_ID`
|
|
|
|
Confirm voice + speaker before long output.
|
|
|
|
## Chat voice responses
|
|
|
|
When Peter asks for a "voice" reply (e.g., "crazy scientist voice", "explain in voice"), generate audio and send it:
|
|
|
|
```bash
|
|
# Generate audio file
|
|
sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here"
|
|
|
|
# Then include in reply:
|
|
# MEDIA:/tmp/voice-reply.mp3
|
|
```
|
|
|
|
Voice character tips:
|
|
|
|
- Crazy scientist: Use `[excited]` tags, dramatic pauses `[short pause]`, vary intensity
|
|
- Calm: Use `[whispers]` or slower pacing
|
|
- Dramatic: Use `[sings]` or `[shouts]` sparingly
|
|
|
|
Default voice for Clawd: `lj2rcrvANS3gaWWnczSX` (or just `-v Clawd`)
|