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 (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

eleven_flash_v2_5

eleven_multilingual_v2

Getting Help

• ElevenLabs Text-to-Speech API
• ElevenLabs Healthcare use cases