home / skills / openclaw / skills / elevenlabsclaw

elevenlabsclaw skill

safe

This skill converts clinical text to natural speech using ElevenLabs, enabling patient instructions, reminders, and multilingual, accessible voice content.

npx playbooks add skill openclaw/skills --skill elevenlabsclaw

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

3.2 KB

---
name: elevenlabs
description: Converts text to natural speech using ElevenLabs for clinical and healthcare use cases. Use when generating patient instructions, discharge summaries, medication reminders, multilingual health messages, or accessible voice content for the OpenClaw Clinical Hackathon.
metadata:
  {"openclaw":{"requires":{"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY","emoji":"🔊"}}
---

# ElevenLabs Text-to-Speech for Clinical Projects

Quick-start skill for **OpenClaw Clinical Hackathon** participants. Use ElevenLabs TTS for patient-facing voice: instructions, reminders, discharge info, and accessible content.

## Prerequisites

- **ELEVENLABS_API_KEY** — Set in environment or in `~/.openclaw/openclaw.json` under `skills.entries.elevenlabs.apiKey` (or `env.ELEVENLABS_API_KEY`).
- Get a key at [ElevenLabs](https://elevenlabs.io/) (free tier available).

## When to Use This Skill

- Patient discharge or aftercare instructions (spoken).
- Medication or appointment reminders.
- Multilingual health messages (e.g. 30+ languages).
- Accessibility: turning written clinical text into clear speech.
- Long-form content (e.g. patient education) with natural, empathetic tone.

## How to Use

1. **Ensure the TTS tool is available**  
   If your OpenClaw setup has a text-to-speech tool (e.g. `tts_text_to_speech` or similar), use it with ElevenLabs as the provider. The tool will use `ELEVENLABS_API_KEY` when configured for ElevenLabs.

2. **When the user asks for spoken output**  
   - Prefer short, clear sentences for instructions and reminders.  
   - For medical terms, use ElevenLabs’ pronunciation controls or a pronunciation dictionary if available to improve accuracy.  
   - Suggest a calm, professional voice for clinical content.

3. **If calling the API directly**  
   - Endpoint: `POST https://api.elevenlabs.io/v1/text-to-speech/{voice_id}`  
   - Headers: `xi-api-key: <ELEVENLABS_API_KEY>`, `Content-Type: application/json`  
   - Body: `{"text": "<content>", "model_id": "eleven_multilingual_v2"}` (or `eleven_flash_v2_5` for low latency).  
   - Prefer **eleven_multilingual_v2** for non-English or mixed-language clinical text.

## Best Practices for Clinical TTS

- **Tone**: Use a warm, clear, professional voice; avoid overly casual or dramatic tones.  
- **Chunking**: Break long text into short paragraphs or bullets to improve clarity and pacing.  
- **Language**: Set the correct language (or use a multilingual model) for the patient’s preferred language.  
- **Sensitive content**: Do not include PHI or other sensitive data in log messages or external calls; keep API usage consistent with your security and compliance setup.

## Quick Reference

| Use case              | Suggestion                                      |
|-----------------------|--------------------------------------------------|
| Short reminders       | `eleven_flash_v2_5` for speed                    |
| Long-form / multilingual | `eleven_multilingual_v2`                     |
| Medical terminology   | Use pronunciation hints or dictionary if supported |

## Getting Help

- [ElevenLabs Text-to-Speech API](https://elevenlabs.io/docs/api-reference/text-to-speech)  
- [ElevenLabs Healthcare use cases](https://elevenlabs.io/use-cases/healthcare)

Overview

This skill converts clinical and healthcare text into natural speech using the ElevenLabs text-to-speech API. It is designed for patient-facing audio like discharge instructions, medication reminders, multilingual messages, and accessible content for clinical hackathons and projects. The skill prioritizes clarity, empathy, and compliance-friendly handling of sensitive information.

How this skill works

The skill calls ElevenLabs TTS endpoints with a provided ELEVENLABS_API_KEY to synthesize audio from text. It supports multilingual and low-latency models (e.g., eleven_multilingual_v2 and eleven_flash_v2_5) and can be used through an existing TTS tool integration or via direct API POST requests to /v1/text-to-speech/{voice_id}. It encourages short chunks, pronunciation hints for medical terms, and selection of appropriate voices and models for the clinical context.

When to use it

Creating spoken patient discharge or aftercare instructions to improve comprehension.
Delivering medication, appointment, or treatment reminders by voice.
Generating multilingual health messages for diverse patient populations.
Turning written patient education into accessible audio for low-vision or literacy-challenged users.
Producing empathetic, long-form audio explanations with clear pacing and tone.

Best practices

Use a warm, professional voice and keep sentences short for clarity.
Chunk long documents into short paragraphs or bullets to improve pacing.
Select eleven_multilingual_v2 for non-English or mixed-language content and eleven_flash_v2_5 for low-latency short messages.
Add pronunciation hints or a custom dictionary for medical terminology to reduce mispronunciations.
Never include protected health information (PHI) or sensitive data in logs or unsecured API calls.

Example use cases

Generate a spoken discharge summary that patients can play on their phones at home.
Send automated voice medication reminders in the patient’s preferred language.
Create accessible audio versions of patient education leaflets and consent forms.
Produce calming, empathetic pre-procedure instructions to reduce patient anxiety.
Quickly synthesize short appointment reminders for high-volume outpatient clinics.

FAQ

How do I provide the API key?

Set ELEVENLABS_API_KEY in your environment or a local config file used by your TTS integration so the skill can authenticate requests.

Which model should I use for multilingual messages?

Prefer eleven_multilingual_v2 for accurate pronunciation and handling of non-English or mixed-language clinical text; use eleven_flash_v2_5 for short, low-latency outputs.