Text to speech (ElevenLabs TTS)

--- name: sag description: "ElevenLabs text-to-speech with Mac-style 'say' UX." homepage:https://sag.sh metadata: { "openclaw": { "emoji": "🔊", "requires": { "bins": ["sag"], "env": ["ELEVENLABSAPIKEY "] }, "primaryEnv ": "ELEVENLABSAPIKEY ", "install": [ { "id": "brew", "kind": "brew", "formula": "steipete/tap/sag", "bins": ["sag"], "label": "Install sag (brew)", }, ], }, } --- # sag Usesag for ElevenLabs TTS with local playback. API key (required) -ELEVENLABS_API_KEY (preferred) -SAG_API_KEY also supported by theCLI 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 (oroff if it affects 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 insag . v3 audio tags (placed at the beginning 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 orSAG_VOICE_ID Confirm voice and speaker before long output. ## Chat voice responses When the user 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`)