{
  "schemaVersion": "1.0",
  "item": {
    "slug": "elevenlabs-voices",
    "name": "ElevenLabs Voices",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/robbyczgw-cla/elevenlabs-voices",
    "canonicalUrl": "https://clawhub.ai/robbyczgw-cla/elevenlabs-voices",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/elevenlabs-voices",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=elevenlabs-voices",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "examples.md",
      "package.json",
      "pronunciations.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/elevenlabs-voices"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/elevenlabs-voices",
    "agentPageUrl": "https://openagent3.xyz/skills/elevenlabs-voices/agent",
    "manifestUrl": "https://openagent3.xyz/skills/elevenlabs-voices/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/elevenlabs-voices/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "ElevenLabs Voice Personas v2.1",
        "body": "Comprehensive voice synthesis toolkit using ElevenLabs API."
      },
      {
        "title": "🚀 First Run - Setup Wizard",
        "body": "When you first use this skill (no config.json exists), run the interactive setup wizard:\n\npython3 scripts/setup.py\n\nThe wizard will guide you through:\n\nAPI Key - Enter your ElevenLabs API key (required)\nDefault Voice - Choose from popular voices (Rachel, Adam, Bella, etc.)\nLanguage - Set your preferred language (32 supported)\nAudio Quality - Standard or high quality output\nCost Tracking - Enable usage and cost monitoring\nBudget Limit - Optional monthly spending cap\n\n🔒 Privacy: Your API key is stored locally in config.json only. It never leaves your machine and is automatically excluded from git via .gitignore.\n\nTo reconfigure at any time, simply run the setup wizard again."
      },
      {
        "title": "✨ Features",
        "body": "18 Voice Personas - Carefully curated voices for different use cases\n32 Languages - Multi-language synthesis with the multilingual v2 model\nStreaming Mode - Real-time audio output as it generates\nSound Effects (SFX) - AI-generated sound effects from text prompts\nBatch Processing - Process multiple texts in one go\nCost Tracking - Monitor character usage and estimated costs\nVoice Design - Create custom voices from descriptions\nPronunciation Dictionary - Custom word pronunciation rules\nOpenClaw Integration - Works with OpenClaw's built-in TTS"
      },
      {
        "title": "🎙 Available Voices",
        "body": "VoiceAccentGenderPersonaBest Forrachel🇺🇸 USfemalewarmConversations, tutorialsadam🇺🇸 USmalenarratorDocumentaries, audiobooksbella🇺🇸 USfemaleprofessionalBusiness, presentationsbrian🇺🇸 USmalecomfortingMeditation, calm contentgeorge🇬🇧 UKmalestorytellerAudiobooks, storytellingalice🇬🇧 UKfemaleeducatorTutorials, explanationscallum🇺🇸 USmaletricksterPlayful, gamingcharlie🇦🇺 AUmaleenergeticSports, motivationjessica🇺🇸 USfemaleplayfulSocial media, casuallily🇬🇧 UKfemaleactressDrama, elegant contentmatilda🇺🇸 USfemaleprofessionalCorporate, newsriver🇺🇸 USneutralneutralInclusive, informativeroger🇺🇸 USmalecasualPodcasts, relaxeddaniel🇬🇧 UKmalebroadcasterNews, announcementseric🇺🇸 USmaletrustworthyBusiness, corporatechris🇺🇸 USmalefriendlyTutorials, approachablewill🇺🇸 USmaleoptimistMotivation, upliftingliam🇺🇸 USmalesocialYouTube, social media"
      },
      {
        "title": "🎯 Quick Presets",
        "body": "default → rachel (warm, friendly)\nnarrator → adam (documentaries)\nprofessional → matilda (corporate)\nstoryteller → george (audiobooks)\neducator → alice (tutorials)\ncalm → brian (meditation)\nenergetic → liam (social media)\ntrustworthy → eric (business)\nneutral → river (inclusive)\nbritish → george\naustralian → charlie\nbroadcaster → daniel (news)"
      },
      {
        "title": "🌍 Supported Languages (32)",
        "body": "The multilingual v2 model supports these languages:\n\nCodeLanguageCodeLanguageenEnglishplPolishdeGermannlDutchesSpanishsvSwedishfrFrenchdaDanishitItalianfiFinnishptPortuguesenoNorwegianruRussiantrTurkishukUkrainiancsCzechjaJapaneseskSlovakkoKoreanhuHungarianzhChineseroRomanianarArabicbgBulgarianhiHindihrCroatiantaTamilelGreekidIndonesianmsMalayviVietnamesethThai\n\n# Synthesize in German\npython3 tts.py --text \"Guten Tag!\" --voice rachel --lang de\n\n# Synthesize in French\npython3 tts.py --text \"Bonjour le monde!\" --voice adam --lang fr\n\n# List all languages\npython3 tts.py --languages"
      },
      {
        "title": "Basic Text-to-Speech",
        "body": "# List all voices\npython3 scripts/tts.py --list\n\n# Generate speech\npython3 scripts/tts.py --text \"Hello world\" --voice rachel --output hello.mp3\n\n# Use a preset\npython3 scripts/tts.py --text \"Breaking news...\" --voice broadcaster --output news.mp3\n\n# Multi-language\npython3 scripts/tts.py --text \"Bonjour!\" --voice rachel --lang fr --output french.mp3"
      },
      {
        "title": "Streaming Mode",
        "body": "Generate audio with real-time streaming (good for long texts):\n\n# Stream audio as it generates\npython3 scripts/tts.py --text \"This is a long story...\" --voice adam --stream\n\n# Streaming with custom output\npython3 scripts/tts.py --text \"Chapter one...\" --voice george --stream --output chapter1.mp3"
      },
      {
        "title": "Batch Processing",
        "body": "Process multiple texts from a file:\n\n# From newline-separated text file\npython3 scripts/tts.py --batch texts.txt --voice rachel --output-dir ./audio\n\n# From JSON file\npython3 scripts/tts.py --batch batch.json --output-dir ./output\n\nJSON batch format:\n\n[\n  {\"text\": \"First line\", \"voice\": \"rachel\", \"output\": \"line1.mp3\"},\n  {\"text\": \"Second line\", \"voice\": \"adam\", \"output\": \"line2.mp3\"},\n  {\"text\": \"Third line\"}\n]\n\nSimple text format (one per line):\n\nHello, this is the first sentence.\nThis is the second sentence.\nAnd this is the third."
      },
      {
        "title": "Usage Statistics",
        "body": "# Show usage stats and cost estimates\npython3 scripts/tts.py --stats\n\n# Reset statistics\npython3 scripts/tts.py --reset-stats"
      },
      {
        "title": "🎵 Sound Effects (SFX)",
        "body": "Generate AI-powered sound effects from text descriptions:\n\n# Generate a sound effect\npython3 scripts/sfx.py --prompt \"Thunder rumbling in the distance\"\n\n# With specific duration (0.5-22 seconds)\npython3 scripts/sfx.py --prompt \"Cat meowing\" --duration 3 --output cat.mp3\n\n# Adjust prompt influence (0.0-1.0)\npython3 scripts/sfx.py --prompt \"Footsteps on gravel\" --influence 0.5\n\n# Batch SFX generation\npython3 scripts/sfx.py --batch sounds.json --output-dir ./sfx\n\n# Show prompt examples\npython3 scripts/sfx.py --examples\n\nExample prompts:\n\n\"Thunder rumbling in the distance\"\n\"Cat purring contentedly\"\n\"Typing on a mechanical keyboard\"\n\"Spaceship engine humming\"\n\"Coffee shop background chatter\""
      },
      {
        "title": "🎨 Voice Design",
        "body": "Create custom voices from text descriptions:\n\n# Basic voice design\npython3 scripts/voice-design.py --gender female --age middle_aged --accent american \\\n  --description \"A warm, motherly voice\"\n\n# With custom preview text\npython3 scripts/voice-design.py --gender male --age young --accent british \\\n  --text \"Welcome to the adventure!\" --output preview.mp3\n\n# Save to your ElevenLabs library\npython3 scripts/voice-design.py --gender female --age young --accent american \\\n  --description \"Energetic podcast host\" --save \"MyHost\"\n\n# List all design options\npython3 scripts/voice-design.py --options\n\nVoice Design Options:\n\nOptionValuesGendermale, female, neutralAgeyoung, middle_aged, oldAccentamerican, british, african, australian, indian, latin, middle_eastern, scandinavian, eastern_europeanAccent Strength0.3-2.0 (subtle to strong)"
      },
      {
        "title": "📖 Pronunciation Dictionary",
        "body": "Customize how words are pronounced:\n\nEdit pronunciations.json:\n\n{\n  \"rules\": [\n    {\n      \"word\": \"OpenClaw\",\n      \"replacement\": \"Open Claw\",\n      \"comment\": \"Pronounce as two words\"\n    },\n    {\n      \"word\": \"API\",\n      \"replacement\": \"A P I\",\n      \"comment\": \"Spell out acronym\"\n    }\n  ]\n}\n\nUsage:\n\n# Pronunciations are applied automatically\npython3 scripts/tts.py --text \"The OpenClaw API is great\" --voice rachel\n\n# Disable pronunciations\npython3 scripts/tts.py --text \"The API is great\" --voice rachel --no-pronunciations"
      },
      {
        "title": "💰 Cost Tracking",
        "body": "The skill tracks your character usage and estimates costs:\n\npython3 scripts/tts.py --stats\n\nOutput:\n\n📊 ElevenLabs Usage Statistics\n\n  Total Characters: 15,230\n  Total Requests:   42\n  Since:            2024-01-15\n\n💰 Estimated Costs:\n  Starter    $4.57 ($0.30/1k chars)\n  Creator    $3.66 ($0.24/1k chars)\n  Pro        $2.74 ($0.18/1k chars)\n  Scale      $1.68 ($0.11/1k chars)"
      },
      {
        "title": "Using with OpenClaw's Built-in TTS",
        "body": "OpenClaw has built-in TTS support that can use ElevenLabs. Configure in ~/.openclaw/openclaw.json:\n\n{\n  \"tts\": {\n    \"enabled\": true,\n    \"provider\": \"elevenlabs\",\n    \"elevenlabs\": {\n      \"apiKey\": \"your-api-key-here\",\n      \"voice\": \"rachel\",\n      \"model\": \"eleven_multilingual_v2\"\n    }\n  }\n}"
      },
      {
        "title": "Triggering TTS in Chat",
        "body": "In OpenClaw conversations:\n\nUse /tts on to enable automatic TTS\nUse the tts tool directly for one-off speech\nRequest \"read this aloud\" or \"speak this\""
      },
      {
        "title": "Using Skill Scripts from OpenClaw",
        "body": "# OpenClaw can run these scripts directly\nexec python3 /path/to/skills/elevenlabs-voices/scripts/tts.py --text \"Hello\" --voice rachel"
      },
      {
        "title": "⚙ Configuration",
        "body": "The scripts look for API key in this order:\n\nELEVEN_API_KEY or ELEVENLABS_API_KEY environment variable\nSkill-local .env file (in the skill directory)\n\nCreate .env file:\n\necho 'ELEVEN_API_KEY=your-key-here' > .env\n\nNote: The skill no longer reads from ~/.openclaw/openclaw.json. Use environment variables or the skill-local .env file."
      },
      {
        "title": "🎛 Voice Settings",
        "body": "Each voice has tuned settings for optimal output:\n\nSettingRangeDescriptionstability0.0-1.0Higher = consistent, lower = expressivesimilarity_boost0.0-1.0How closely to match original voicestyle0.0-1.0Exaggeration of speaking style"
      },
      {
        "title": "📝 Triggers",
        "body": "\"use {voice_name} voice\"\n\"speak as {persona}\"\n\"list voices\"\n\"voice settings\"\n\"generate sound effect\"\n\"design a voice\""
      },
      {
        "title": "📁 Files",
        "body": "elevenlabs-voices/\n├── SKILL.md              # This documentation\n├── README.md             # Quick start guide\n├── config.json           # Your local config (created by setup, in .gitignore)\n├── voices.json           # Voice definitions & settings\n├── pronunciations.json   # Custom pronunciation rules\n├── examples.md           # Detailed usage examples\n├── scripts/\n│   ├── setup.py          # Interactive setup wizard\n│   ├── tts.py            # Main TTS script\n│   ├── sfx.py            # Sound effects generator\n│   └── voice-design.py   # Voice design tool\n└── references/\n    └── voice-guide.md    # Voice selection guide"
      },
      {
        "title": "🔗 Links",
        "body": "ElevenLabs\nAPI Documentation\nVoice Library\nSound Effects API\nVoice Design API"
      },
      {
        "title": "v2.1.0",
        "body": "Added interactive setup wizard (scripts/setup.py)\nOnboarding guides through API key, voice, language, quality, and budget settings\nConfig stored locally in config.json (added to .gitignore)\nProfessional, privacy-focused setup experience"
      },
      {
        "title": "v2.0.0",
        "body": "Added 32 language support with --lang parameter\nAdded streaming mode with --stream flag\nAdded sound effects generation (sfx.py)\nAdded batch processing with --batch flag\nAdded cost tracking with --stats flag\nAdded voice design tool (voice-design.py)\nAdded pronunciation dictionary support\nAdded OpenClaw TTS integration documentation\nImproved error handling and progress output"
      }
    ],
    "body": "ElevenLabs Voice Personas v2.1\n\nComprehensive voice synthesis toolkit using ElevenLabs API.\n\n🚀 First Run - Setup Wizard\n\nWhen you first use this skill (no config.json exists), run the interactive setup wizard:\n\npython3 scripts/setup.py\n\n\nThe wizard will guide you through:\n\nAPI Key - Enter your ElevenLabs API key (required)\nDefault Voice - Choose from popular voices (Rachel, Adam, Bella, etc.)\nLanguage - Set your preferred language (32 supported)\nAudio Quality - Standard or high quality output\nCost Tracking - Enable usage and cost monitoring\nBudget Limit - Optional monthly spending cap\n\n🔒 Privacy: Your API key is stored locally in config.json only. It never leaves your machine and is automatically excluded from git via .gitignore.\n\nTo reconfigure at any time, simply run the setup wizard again.\n\n✨ Features\n18 Voice Personas - Carefully curated voices for different use cases\n32 Languages - Multi-language synthesis with the multilingual v2 model\nStreaming Mode - Real-time audio output as it generates\nSound Effects (SFX) - AI-generated sound effects from text prompts\nBatch Processing - Process multiple texts in one go\nCost Tracking - Monitor character usage and estimated costs\nVoice Design - Create custom voices from descriptions\nPronunciation Dictionary - Custom word pronunciation rules\nOpenClaw Integration - Works with OpenClaw's built-in TTS\n🎙 Available Voices\nVoice\tAccent\tGender\tPersona\tBest For\nrachel\t🇺🇸 US\tfemale\twarm\tConversations, tutorials\nadam\t🇺🇸 US\tmale\tnarrator\tDocumentaries, audiobooks\nbella\t🇺🇸 US\tfemale\tprofessional\tBusiness, presentations\nbrian\t🇺🇸 US\tmale\tcomforting\tMeditation, calm content\ngeorge\t🇬🇧 UK\tmale\tstoryteller\tAudiobooks, storytelling\nalice\t🇬🇧 UK\tfemale\teducator\tTutorials, explanations\ncallum\t🇺🇸 US\tmale\ttrickster\tPlayful, gaming\ncharlie\t🇦🇺 AU\tmale\tenergetic\tSports, motivation\njessica\t🇺🇸 US\tfemale\tplayful\tSocial media, casual\nlily\t🇬🇧 UK\tfemale\tactress\tDrama, elegant content\nmatilda\t🇺🇸 US\tfemale\tprofessional\tCorporate, news\nriver\t🇺🇸 US\tneutral\tneutral\tInclusive, informative\nroger\t🇺🇸 US\tmale\tcasual\tPodcasts, relaxed\ndaniel\t🇬🇧 UK\tmale\tbroadcaster\tNews, announcements\neric\t🇺🇸 US\tmale\ttrustworthy\tBusiness, corporate\nchris\t🇺🇸 US\tmale\tfriendly\tTutorials, approachable\nwill\t🇺🇸 US\tmale\toptimist\tMotivation, uplifting\nliam\t🇺🇸 US\tmale\tsocial\tYouTube, social media\n🎯 Quick Presets\ndefault → rachel (warm, friendly)\nnarrator → adam (documentaries)\nprofessional → matilda (corporate)\nstoryteller → george (audiobooks)\neducator → alice (tutorials)\ncalm → brian (meditation)\nenergetic → liam (social media)\ntrustworthy → eric (business)\nneutral → river (inclusive)\nbritish → george\naustralian → charlie\nbroadcaster → daniel (news)\n🌍 Supported Languages (32)\n\nThe multilingual v2 model supports these languages:\n\nCode\tLanguage\tCode\tLanguage\nen\tEnglish\tpl\tPolish\nde\tGerman\tnl\tDutch\nes\tSpanish\tsv\tSwedish\nfr\tFrench\tda\tDanish\nit\tItalian\tfi\tFinnish\npt\tPortuguese\tno\tNorwegian\nru\tRussian\ttr\tTurkish\nuk\tUkrainian\tcs\tCzech\nja\tJapanese\tsk\tSlovak\nko\tKorean\thu\tHungarian\nzh\tChinese\tro\tRomanian\nar\tArabic\tbg\tBulgarian\nhi\tHindi\thr\tCroatian\nta\tTamil\tel\tGreek\nid\tIndonesian\tms\tMalay\nvi\tVietnamese\tth\tThai\n# Synthesize in German\npython3 tts.py --text \"Guten Tag!\" --voice rachel --lang de\n\n# Synthesize in French\npython3 tts.py --text \"Bonjour le monde!\" --voice adam --lang fr\n\n# List all languages\npython3 tts.py --languages\n\n💻 CLI Usage\nBasic Text-to-Speech\n# List all voices\npython3 scripts/tts.py --list\n\n# Generate speech\npython3 scripts/tts.py --text \"Hello world\" --voice rachel --output hello.mp3\n\n# Use a preset\npython3 scripts/tts.py --text \"Breaking news...\" --voice broadcaster --output news.mp3\n\n# Multi-language\npython3 scripts/tts.py --text \"Bonjour!\" --voice rachel --lang fr --output french.mp3\n\nStreaming Mode\n\nGenerate audio with real-time streaming (good for long texts):\n\n# Stream audio as it generates\npython3 scripts/tts.py --text \"This is a long story...\" --voice adam --stream\n\n# Streaming with custom output\npython3 scripts/tts.py --text \"Chapter one...\" --voice george --stream --output chapter1.mp3\n\nBatch Processing\n\nProcess multiple texts from a file:\n\n# From newline-separated text file\npython3 scripts/tts.py --batch texts.txt --voice rachel --output-dir ./audio\n\n# From JSON file\npython3 scripts/tts.py --batch batch.json --output-dir ./output\n\n\nJSON batch format:\n\n[\n  {\"text\": \"First line\", \"voice\": \"rachel\", \"output\": \"line1.mp3\"},\n  {\"text\": \"Second line\", \"voice\": \"adam\", \"output\": \"line2.mp3\"},\n  {\"text\": \"Third line\"}\n]\n\n\nSimple text format (one per line):\n\nHello, this is the first sentence.\nThis is the second sentence.\nAnd this is the third.\n\nUsage Statistics\n# Show usage stats and cost estimates\npython3 scripts/tts.py --stats\n\n# Reset statistics\npython3 scripts/tts.py --reset-stats\n\n🎵 Sound Effects (SFX)\n\nGenerate AI-powered sound effects from text descriptions:\n\n# Generate a sound effect\npython3 scripts/sfx.py --prompt \"Thunder rumbling in the distance\"\n\n# With specific duration (0.5-22 seconds)\npython3 scripts/sfx.py --prompt \"Cat meowing\" --duration 3 --output cat.mp3\n\n# Adjust prompt influence (0.0-1.0)\npython3 scripts/sfx.py --prompt \"Footsteps on gravel\" --influence 0.5\n\n# Batch SFX generation\npython3 scripts/sfx.py --batch sounds.json --output-dir ./sfx\n\n# Show prompt examples\npython3 scripts/sfx.py --examples\n\n\nExample prompts:\n\n\"Thunder rumbling in the distance\"\n\"Cat purring contentedly\"\n\"Typing on a mechanical keyboard\"\n\"Spaceship engine humming\"\n\"Coffee shop background chatter\"\n🎨 Voice Design\n\nCreate custom voices from text descriptions:\n\n# Basic voice design\npython3 scripts/voice-design.py --gender female --age middle_aged --accent american \\\n  --description \"A warm, motherly voice\"\n\n# With custom preview text\npython3 scripts/voice-design.py --gender male --age young --accent british \\\n  --text \"Welcome to the adventure!\" --output preview.mp3\n\n# Save to your ElevenLabs library\npython3 scripts/voice-design.py --gender female --age young --accent american \\\n  --description \"Energetic podcast host\" --save \"MyHost\"\n\n# List all design options\npython3 scripts/voice-design.py --options\n\n\nVoice Design Options:\n\nOption\tValues\nGender\tmale, female, neutral\nAge\tyoung, middle_aged, old\nAccent\tamerican, british, african, australian, indian, latin, middle_eastern, scandinavian, eastern_european\nAccent Strength\t0.3-2.0 (subtle to strong)\n📖 Pronunciation Dictionary\n\nCustomize how words are pronounced:\n\nEdit pronunciations.json:\n\n{\n  \"rules\": [\n    {\n      \"word\": \"OpenClaw\",\n      \"replacement\": \"Open Claw\",\n      \"comment\": \"Pronounce as two words\"\n    },\n    {\n      \"word\": \"API\",\n      \"replacement\": \"A P I\",\n      \"comment\": \"Spell out acronym\"\n    }\n  ]\n}\n\n\nUsage:\n\n# Pronunciations are applied automatically\npython3 scripts/tts.py --text \"The OpenClaw API is great\" --voice rachel\n\n# Disable pronunciations\npython3 scripts/tts.py --text \"The API is great\" --voice rachel --no-pronunciations\n\n💰 Cost Tracking\n\nThe skill tracks your character usage and estimates costs:\n\npython3 scripts/tts.py --stats\n\n\nOutput:\n\n📊 ElevenLabs Usage Statistics\n\n  Total Characters: 15,230\n  Total Requests:   42\n  Since:            2024-01-15\n\n💰 Estimated Costs:\n  Starter    $4.57 ($0.30/1k chars)\n  Creator    $3.66 ($0.24/1k chars)\n  Pro        $2.74 ($0.18/1k chars)\n  Scale      $1.68 ($0.11/1k chars)\n\n🤖 OpenClaw TTS Integration\nUsing with OpenClaw's Built-in TTS\n\nOpenClaw has built-in TTS support that can use ElevenLabs. Configure in ~/.openclaw/openclaw.json:\n\n{\n  \"tts\": {\n    \"enabled\": true,\n    \"provider\": \"elevenlabs\",\n    \"elevenlabs\": {\n      \"apiKey\": \"your-api-key-here\",\n      \"voice\": \"rachel\",\n      \"model\": \"eleven_multilingual_v2\"\n    }\n  }\n}\n\nTriggering TTS in Chat\n\nIn OpenClaw conversations:\n\nUse /tts on to enable automatic TTS\nUse the tts tool directly for one-off speech\nRequest \"read this aloud\" or \"speak this\"\nUsing Skill Scripts from OpenClaw\n# OpenClaw can run these scripts directly\nexec python3 /path/to/skills/elevenlabs-voices/scripts/tts.py --text \"Hello\" --voice rachel\n\n⚙ Configuration\n\nThe scripts look for API key in this order:\n\nELEVEN_API_KEY or ELEVENLABS_API_KEY environment variable\nSkill-local .env file (in the skill directory)\n\nCreate .env file:\n\necho 'ELEVEN_API_KEY=your-key-here' > .env\n\n\nNote: The skill no longer reads from ~/.openclaw/openclaw.json. Use environment variables or the skill-local .env file.\n\n🎛 Voice Settings\n\nEach voice has tuned settings for optimal output:\n\nSetting\tRange\tDescription\nstability\t0.0-1.0\tHigher = consistent, lower = expressive\nsimilarity_boost\t0.0-1.0\tHow closely to match original voice\nstyle\t0.0-1.0\tExaggeration of speaking style\n📝 Triggers\n\"use {voice_name} voice\"\n\"speak as {persona}\"\n\"list voices\"\n\"voice settings\"\n\"generate sound effect\"\n\"design a voice\"\n📁 Files\nelevenlabs-voices/\n├── SKILL.md              # This documentation\n├── README.md             # Quick start guide\n├── config.json           # Your local config (created by setup, in .gitignore)\n├── voices.json           # Voice definitions & settings\n├── pronunciations.json   # Custom pronunciation rules\n├── examples.md           # Detailed usage examples\n├── scripts/\n│   ├── setup.py          # Interactive setup wizard\n│   ├── tts.py            # Main TTS script\n│   ├── sfx.py            # Sound effects generator\n│   └── voice-design.py   # Voice design tool\n└── references/\n    └── voice-guide.md    # Voice selection guide\n\n🔗 Links\nElevenLabs\nAPI Documentation\nVoice Library\nSound Effects API\nVoice Design API\n📋 Changelog\nv2.1.0\nAdded interactive setup wizard (scripts/setup.py)\nOnboarding guides through API key, voice, language, quality, and budget settings\nConfig stored locally in config.json (added to .gitignore)\nProfessional, privacy-focused setup experience\nv2.0.0\nAdded 32 language support with --lang parameter\nAdded streaming mode with --stream flag\nAdded sound effects generation (sfx.py)\nAdded batch processing with --batch flag\nAdded cost tracking with --stats flag\nAdded voice design tool (voice-design.py)\nAdded pronunciation dictionary support\nAdded OpenClaw TTS integration documentation\nImproved error handling and progress output"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/robbyczgw-cla/elevenlabs-voices",
    "publisherUrl": "https://clawhub.ai/robbyczgw-cla/elevenlabs-voices",
    "owner": "robbyczgw-cla",
    "version": "2.1.6",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/elevenlabs-voices",
    "downloadUrl": "https://openagent3.xyz/downloads/elevenlabs-voices",
    "agentUrl": "https://openagent3.xyz/skills/elevenlabs-voices/agent",
    "manifestUrl": "https://openagent3.xyz/skills/elevenlabs-voices/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/elevenlabs-voices/agent.md"
  }
}