elevenlabs

# 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.  
- **L...

# ElevenLabs Audio & Music Skill for OpenClaw Clinical Hackathon

A [ClawHub](https://clawhub.ai/) skill that adds **ElevenLabs text-to-speech** and **Eleven Music (text-to-music)** to your OpenClaw agent for clinical and healthcare projects. Built for participants of the **OpenClaw Clinical Hackathon** who want to deliver patient-facing voice content—instructions, reminders, discharge information, accessible messaging, and **music therapy soundscapes**—with minimal setup.

---

## Table of Contents

- [Overview](#overview)
- [Features](#features)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Configuration](#configuration)
- [Getting an ElevenLabs API Key](#getting-an-elevenlabs-api-key)
- [Usage](#usage)
- [Clinical Use Cases](#clinical-use-cases)
- [Music Therapy & Eleven Music](#music-therapy--eleven-music)
- [Models and Voices](#models-and-voices)
- [Best Practices](#best-practices)
- [Troubleshooting](#troubleshooting)
- [Publishing to ClawHub](#publishing-to-clawhub)
- [Project Structure](#project-structure)
- [Resources and Links](#resources-and-links)
- [License](#license)

---

## Overview

This skill teaches your OpenClaw agent **when** and **how** to use:

- The [ElevenLabs Text-to-Speech API](https://elevenlabs.io/docs/api-reference/text-to-speech) for healthcare scenarios, and
- The [Eleven Music API](https://elevenlabs.io/docs/capabilities/music) to generate music from natural language prompts.

Once installed and configured with an API key, the agent can:

- Generate natural, human-like speech from clinical text (discharge instructions, medication reminders, patient education).
- Support **30+ languages** for multilingual patient communication.
- Create **music therapy soundscapes** and background tracks via text-to-music (relaxation, focus, sleep, stress reduction).
- Use low-latency or high-quality models depending on the use case (short reminders vs. long-form content).
- Follow clinical best practices: clear pronunciation, p...