sag

Original：🇺🇸 English

Not Translated

ElevenLabs text-to-speech with mac-style say UX.

1installs

Sourceheldinhow/openclaw-swarm

Added on2026-02-24

NPX Install

npx skill4agent add heldinhow/openclaw-swarm sag

SKILL.md Content

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

)