[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6Q4P7REK1TGFSJ6B6VTT9YA":3,"skill-same:01M6Q4P7REK1TGFSJ6B6VTT9YA":140},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":30,"publishedAt":51,"linkOnly":52,"markdownContent":53,"markdownBody":54,"frontMatter":55,"refName":66,"commitSha":67,"skillDirectory":68,"forksCount":69,"repositoryHtmlUrl":70,"repositoryHomepageUrl":6,"ownerHtmlUrl":71,"ownerBlogUrl":6,"ownerDescription":72,"updatedAt":73,"install":74,"resources":87},"01M6Q4P7REK1TGFSJ6B6VTT9YA","elevenlabs-voices",null,"High-quality voice synthesis with 18 personas, 32 languages, sound effects, batch processing, and voice design using ElevenLabs API.","Kernel8901\u002Fai-agent-skills-classification","Kernel8901","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F72647553?v=4","01M6KV388J2H5PNC8D8P940BJD","01M6KV38CS5B3AY63RKZB410YM",7,"MIT","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002FSKILL.md",[17,22,25],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":26,"categoryName":27,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50],"elevenlabs voices","elevenlabs","effects","design","high","with","processing","sound effects","personas","voice-design","sound-effects","multilingual","python3","quality","voice","tts","Audio","api","batch","speech","2026-11-10 10:12:30",false,"---\nname: elevenlabs-voices\nversion: 2.1.3\ndescription: High-quality voice synthesis with 18 personas, 32 languages, sound effects, batch processing, and voice design using ElevenLabs API.\ntags: [tts, voice, speech, elevenlabs, audio, sound-effects, voice-design, multilingual]\nmetadata: {\"clawdbot\":{\"requires\":{\"bins\":[\"python3\"],\"env\":[\"ELEVEN_API_KEY\",\"ELEVENLABS_API_KEY\"]},\"primaryEnv\":\"ELEVEN_API_KEY\"}}\n---\n\n# 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\n```bash\npython3 scripts\u002Fsetup.py\n```\n\nThe wizard will guide you through:\n1. **API Key** - Enter your ElevenLabs API key (required)\n2. **Default Voice** - Choose from popular voices (Rachel, Adam, Bella, etc.)\n3. **Language** - Set your preferred language (32 supported)\n4. **Audio Quality** - Standard or high quality output\n5. **Cost Tracking** - Enable usage and cost monitoring\n6. **Budget 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---\n\n## ✨ Features\n\n- **18 Voice Personas** - Carefully curated voices for different use cases\n- **32 Languages** - Multi-language synthesis with the multilingual v2 model\n- **Streaming Mode** - Real-time audio output as it generates\n- **Sound Effects (SFX)** - AI-generated sound effects from text prompts\n- **Batch Processing** - Process multiple texts in one go\n- **Cost Tracking** - Monitor character usage and estimated costs\n- **Voice Design** - Create custom voices from descriptions\n- **Pronunciation Dictionary** - Custom word pronunciation rules\n- **OpenClaw Integration** - Works with OpenClaw's built-in TTS\n\n---\n\n## ?️ Available Voices\n\n| Voice | Accent | Gender | Persona | Best For |\n|-------|--------|--------|---------|----------|\n| rachel | ?? US | female | warm | Conversations, tutorials |\n| adam | ?? US | male | narrator | Documentaries, audiobooks |\n| bella | ?? US | female | professional | Business, presentations |\n| brian | ?? US | male | comforting | Meditation, calm content |\n| george | ?? UK | male | storyteller | Audiobooks, storytelling |\n| alice | ?? UK | female | educator | Tutorials, explanations |\n| callum | ?? US | male | trickster | Playful, gaming |\n| charlie | ?? AU | male | energetic | Sports, motivation |\n| jessica | ?? US | female | playful | Social media, casual |\n| lily | ?? UK | female | actress | Drama, elegant content |\n| matilda | ?? US | female | professional | Corporate, news |\n| river | ?? US | neutral | neutral | Inclusive, informative |\n| roger | ?? US | male | casual | Podcasts, relaxed |\n| daniel | ?? UK | male | broadcaster | News, announcements |\n| eric | ?? US | male | trustworthy | Business, corporate |\n| chris | ?? US | male | friendly | Tutorials, approachable |\n| will | ?? US | male | optimist | Motivation, uplifting |\n| liam | ?? US | male | social | YouTube, social media |\n\n## ? Quick Presets\n\n- `default` → rachel (warm, friendly)\n- `narrator` → adam (documentaries)\n- `professional` → matilda (corporate)\n- `storyteller` → george (audiobooks)\n- `educator` → alice (tutorials)\n- `calm` → brian (meditation)\n- `energetic` → liam (social media)\n- `trustworthy` → eric (business)\n- `neutral` → river (inclusive)\n- `british` → george\n- `australian` → charlie\n- `broadcaster` → daniel (news)\n\n---\n\n## ? Supported Languages (32)\n\nThe multilingual v2 model supports these languages:\n\n| Code | Language | Code | Language |\n|------|----------|------|----------|\n| en | English | pl | Polish |\n| de | German | nl | Dutch |\n| es | Spanish | sv | Swedish |\n| fr | French | da | Danish |\n| it | Italian | fi | Finnish |\n| pt | Portuguese | no | Norwegian |\n| ru | Russian | tr | Turkish |\n| uk | Ukrainian | cs | Czech |\n| ja | Japanese | sk | Slovak |\n| ko | Korean | hu | Hungarian |\n| zh | Chinese | ro | Romanian |\n| ar | Arabic | bg | Bulgarian |\n| hi | Hindi | hr | Croatian |\n| ta | Tamil | el | Greek |\n| id | Indonesian | ms | Malay |\n| vi | Vietnamese | th | Thai |\n\n```bash\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\n---\n\n## ? CLI Usage\n\n### Basic Text-to-Speech\n\n```bash\n# List all voices\npython3 scripts\u002Ftts.py --list\n\n# Generate speech\npython3 scripts\u002Ftts.py --text \"Hello world\" --voice rachel --output hello.mp3\n\n# Use a preset\npython3 scripts\u002Ftts.py --text \"Breaking news...\" --voice broadcaster --output news.mp3\n\n# Multi-language\npython3 scripts\u002Ftts.py --text \"Bonjour!\" --voice rachel --lang fr --output french.mp3\n```\n\n### Streaming Mode\n\nGenerate audio with real-time streaming (good for long texts):\n\n```bash\n# Stream audio as it generates\npython3 scripts\u002Ftts.py --text \"This is a long story...\" --voice adam --stream\n\n# Streaming with custom output\npython3 scripts\u002Ftts.py --text \"Chapter one...\" --voice george --stream --output chapter1.mp3\n```\n\n### Batch Processing\n\nProcess multiple texts from a file:\n\n```bash\n# From newline-separated text file\npython3 scripts\u002Ftts.py --batch texts.txt --voice rachel --output-dir .\u002Faudio\n\n# From JSON file\npython3 scripts\u002Ftts.py --batch batch.json --output-dir .\u002Foutput\n```\n\n**JSON batch format:**\n```json\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\n**Simple text format (one per line):**\n```\nHello, this is the first sentence.\nThis is the second sentence.\nAnd this is the third.\n```\n\n### Usage Statistics\n\n```bash\n# Show usage stats and cost estimates\npython3 scripts\u002Ftts.py --stats\n\n# Reset statistics\npython3 scripts\u002Ftts.py --reset-stats\n```\n\n---\n\n## ? Sound Effects (SFX)\n\nGenerate AI-powered sound effects from text descriptions:\n\n```bash\n# Generate a sound effect\npython3 scripts\u002Fsfx.py --prompt \"Thunder rumbling in the distance\"\n\n# With specific duration (0.5-22 seconds)\npython3 scripts\u002Fsfx.py --prompt \"Cat meowing\" --duration 3 --output cat.mp3\n\n# Adjust prompt influence (0.0-1.0)\npython3 scripts\u002Fsfx.py --prompt \"Footsteps on gravel\" --influence 0.5\n\n# Batch SFX generation\npython3 scripts\u002Fsfx.py --batch sounds.json --output-dir .\u002Fsfx\n\n# Show prompt examples\npython3 scripts\u002Fsfx.py --examples\n```\n\n**Example prompts:**\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\n---\n\n## ? Voice Design\n\nCreate custom voices from text descriptions:\n\n```bash\n# Basic voice design\npython3 scripts\u002Fvoice-design.py --gender female --age middle_aged --accent american \\\n  --description \"A warm, motherly voice\"\n\n# With custom preview text\npython3 scripts\u002Fvoice-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\u002Fvoice-design.py --gender female --age young --accent american \\\n  --description \"Energetic podcast host\" --save \"MyHost\"\n\n# List all design options\npython3 scripts\u002Fvoice-design.py --options\n```\n\n**Voice Design Options:**\n\n| Option | Values |\n|--------|--------|\n| Gender | male, female, neutral |\n| Age | young, middle_aged, old |\n| Accent | american, british, african, australian, indian, latin, middle_eastern, scandinavian, eastern_european |\n| Accent Strength | 0.3-2.0 (subtle to strong) |\n\n---\n\n## ? Pronunciation Dictionary\n\nCustomize how words are pronounced:\n\nEdit `pronunciations.json`:\n```json\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```bash\n# Pronunciations are applied automatically\npython3 scripts\u002Ftts.py --text \"The OpenClaw API is great\" --voice rachel\n\n# Disable pronunciations\npython3 scripts\u002Ftts.py --text \"The API is great\" --voice rachel --no-pronunciations\n```\n\n---\n\n## ? Cost Tracking\n\nThe skill tracks your character usage and estimates costs:\n\n```bash\npython3 scripts\u002Ftts.py --stats\n```\n\n**Output:**\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\u002F1k chars)\n  Creator    $3.66 ($0.24\u002F1k chars)\n  Pro        $2.74 ($0.18\u002F1k chars)\n  Scale      $1.68 ($0.11\u002F1k chars)\n```\n\n---\n\n## ? OpenClaw TTS Integration\n\n### Using with OpenClaw's Built-in TTS\n\nOpenClaw has built-in TTS support that can use ElevenLabs. Configure in `~\u002F.openclaw\u002Fopenclaw.json`:\n\n```json\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```\n\n### Triggering TTS in Chat\n\nIn OpenClaw conversations:\n- Use `\u002Ftts on` to enable automatic TTS\n- Use the `tts` tool directly for one-off speech\n- Request \"read this aloud\" or \"speak this\"\n\n### Using Skill Scripts from OpenClaw\n\n```bash\n# OpenClaw can run these scripts directly\nexec python3 \u002Fpath\u002Fto\u002Fskills\u002Felevenlabs-voices\u002Fscripts\u002Ftts.py --text \"Hello\" --voice rachel\n```\n\n---\n\n## ⚙️ Configuration\n\nThe scripts look for API key in this order:\n\n1. `ELEVEN_API_KEY` or `ELEVENLABS_API_KEY` environment variable\n2. OpenClaw config (`~\u002F.openclaw\u002Fopenclaw.json` → tts.elevenlabs.apiKey)\n3. Skill-local `.env` file\n\n**Create .env file:**\n```bash\necho 'ELEVEN_API_KEY=your-key-here' > .env\n```\n\n---\n\n## ?️ Voice Settings\n\nEach voice has tuned settings for optimal output:\n\n| Setting | Range | Description |\n|---------|-------|-------------|\n| stability | 0.0-1.0 | Higher = consistent, lower = expressive |\n| similarity_boost | 0.0-1.0 | How closely to match original voice |\n| style | 0.0-1.0 | Exaggeration of speaking style |\n\n---\n\n## ? Triggers\n\n- \"use {voice_name} voice\"\n- \"speak as {persona}\"\n- \"list voices\"\n- \"voice settings\"\n- \"generate sound effect\"\n- \"design a voice\"\n\n---\n\n## ? Files\n\n```\nelevenlabs-voices\u002F\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\u002F\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\u002F\n    └── voice-guide.md    # Voice selection guide\n```\n\n---\n\n## ? Links\n\n- [ElevenLabs](https:\u002F\u002Felevenlabs.io)\n- [API Documentation](https:\u002F\u002Fdocs.elevenlabs.io)\n- [Voice Library](https:\u002F\u002Felevenlabs.io\u002Fvoice-library)\n- [Sound Effects API](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fsound-generation)\n- [Voice Design API](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fvoice-generation)\n\n---\n\n## ? Changelog\n\n### v2.1.0\n- Added interactive setup wizard (`scripts\u002Fsetup.py`)\n- Onboarding guides through API key, voice, language, quality, and budget settings\n- Config stored locally in `config.json` (added to `.gitignore`)\n- Professional, privacy-focused setup experience\n\n### v2.0.0\n- Added 32 language support with `--lang` parameter\n- Added streaming mode with `--stream` flag\n- Added sound effects generation (`sfx.py`)\n- Added batch processing with `--batch` flag\n- Added cost tracking with `--stats` flag\n- Added voice design tool (`voice-design.py`)\n- Added pronunciation dictionary support\n- Added OpenClaw TTS integration documentation\n- Improved error handling and progress output\n","# 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\n```bash\npython3 scripts\u002Fsetup.py\n```\n\nThe wizard will guide you through:\n1. **API Key** - Enter your ElevenLabs API key (required)\n2. **Default Voice** - Choose from popular voices (Rachel, Adam, Bella, etc.)\n3. **Language** - Set your preferred language (32 supported)\n4. **Audio Quality** - Standard or high quality output\n5. **Cost Tracking** - Enable usage and cost monitoring\n6. **Budget 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---\n\n## ✨ Features\n\n- **18 Voice Personas** - Carefully curated voices for different use cases\n- **32 Languages** - Multi-language synthesis with the multilingual v2 model\n- **Streaming Mode** - Real-time audio output as it generates\n- **Sound Effects (SFX)** - AI-generated sound effects from text prompts\n- **Batch Processing** - Process multiple texts in one go\n- **Cost Tracking** - Monitor character usage and estimated costs\n- **Voice Design** - Create custom voices from descriptions\n- **Pronunciation Dictionary** - Custom word pronunciation rules\n- **OpenClaw Integration** - Works with OpenClaw's built-in TTS\n\n---\n\n## ?️ Available Voices\n\n| Voice | Accent | Gender | Persona | Best For |\n|-------|--------|--------|---------|----------|\n| rachel | ?? US | female | warm | Conversations, tutorials |\n| adam | ?? US | male | narrator | Documentaries, audiobooks |\n| bella | ?? US | female | professional | Business, presentations |\n| brian | ?? US | male | comforting | Meditation, calm content |\n| george | ?? UK | male | storyteller | Audiobooks, storytelling |\n| alice | ?? UK | female | educator | Tutorials, explanations |\n| callum | ?? US | male | trickster | Playful, gaming |\n| charlie | ?? AU | male | energetic | Sports, motivation |\n| jessica | ?? US | female | playful | Social media, casual |\n| lily | ?? UK | female | actress | Drama, elegant content |\n| matilda | ?? US | female | professional | Corporate, news |\n| river | ?? US | neutral | neutral | Inclusive, informative |\n| roger | ?? US | male | casual | Podcasts, relaxed |\n| daniel | ?? UK | male | broadcaster | News, announcements |\n| eric | ?? US | male | trustworthy | Business, corporate |\n| chris | ?? US | male | friendly | Tutorials, approachable |\n| will | ?? US | male | optimist | Motivation, uplifting |\n| liam | ?? US | male | social | YouTube, social media |\n\n## ? Quick Presets\n\n- `default` → rachel (warm, friendly)\n- `narrator` → adam (documentaries)\n- `professional` → matilda (corporate)\n- `storyteller` → george (audiobooks)\n- `educator` → alice (tutorials)\n- `calm` → brian (meditation)\n- `energetic` → liam (social media)\n- `trustworthy` → eric (business)\n- `neutral` → river (inclusive)\n- `british` → george\n- `australian` → charlie\n- `broadcaster` → daniel (news)\n\n---\n\n## ? Supported Languages (32)\n\nThe multilingual v2 model supports these languages:\n\n| Code | Language | Code | Language |\n|------|----------|------|----------|\n| en | English | pl | Polish |\n| de | German | nl | Dutch |\n| es | Spanish | sv | Swedish |\n| fr | French | da | Danish |\n| it | Italian | fi | Finnish |\n| pt | Portuguese | no | Norwegian |\n| ru | Russian | tr | Turkish |\n| uk | Ukrainian | cs | Czech |\n| ja | Japanese | sk | Slovak |\n| ko | Korean | hu | Hungarian |\n| zh | Chinese | ro | Romanian |\n| ar | Arabic | bg | Bulgarian |\n| hi | Hindi | hr | Croatian |\n| ta | Tamil | el | Greek |\n| id | Indonesian | ms | Malay |\n| vi | Vietnamese | th | Thai |\n\n```bash\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\n---\n\n## ? CLI Usage\n\n### Basic Text-to-Speech\n\n```bash\n# List all voices\npython3 scripts\u002Ftts.py --list\n\n# Generate speech\npython3 scripts\u002Ftts.py --text \"Hello world\" --voice rachel --output hello.mp3\n\n# Use a preset\npython3 scripts\u002Ftts.py --text \"Breaking news...\" --voice broadcaster --output news.mp3\n\n# Multi-language\npython3 scripts\u002Ftts.py --text \"Bonjour!\" --voice rachel --lang fr --output french.mp3\n```\n\n### Streaming Mode\n\nGenerate audio with real-time streaming (good for long texts):\n\n```bash\n# Stream audio as it generates\npython3 scripts\u002Ftts.py --text \"This is a long story...\" --voice adam --stream\n\n# Streaming with custom output\npython3 scripts\u002Ftts.py --text \"Chapter one...\" --voice george --stream --output chapter1.mp3\n```\n\n### Batch Processing\n\nProcess multiple texts from a file:\n\n```bash\n# From newline-separated text file\npython3 scripts\u002Ftts.py --batch texts.txt --voice rachel --output-dir .\u002Faudio\n\n# From JSON file\npython3 scripts\u002Ftts.py --batch batch.json --output-dir .\u002Foutput\n```\n\n**JSON batch format:**\n```json\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\n**Simple text format (one per line):**\n```\nHello, this is the first sentence.\nThis is the second sentence.\nAnd this is the third.\n```\n\n### Usage Statistics\n\n```bash\n# Show usage stats and cost estimates\npython3 scripts\u002Ftts.py --stats\n\n# Reset statistics\npython3 scripts\u002Ftts.py --reset-stats\n```\n\n---\n\n## ? Sound Effects (SFX)\n\nGenerate AI-powered sound effects from text descriptions:\n\n```bash\n# Generate a sound effect\npython3 scripts\u002Fsfx.py --prompt \"Thunder rumbling in the distance\"\n\n# With specific duration (0.5-22 seconds)\npython3 scripts\u002Fsfx.py --prompt \"Cat meowing\" --duration 3 --output cat.mp3\n\n# Adjust prompt influence (0.0-1.0)\npython3 scripts\u002Fsfx.py --prompt \"Footsteps on gravel\" --influence 0.5\n\n# Batch SFX generation\npython3 scripts\u002Fsfx.py --batch sounds.json --output-dir .\u002Fsfx\n\n# Show prompt examples\npython3 scripts\u002Fsfx.py --examples\n```\n\n**Example prompts:**\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\n---\n\n## ? Voice Design\n\nCreate custom voices from text descriptions:\n\n```bash\n# Basic voice design\npython3 scripts\u002Fvoice-design.py --gender female --age middle_aged --accent american \\\n  --description \"A warm, motherly voice\"\n\n# With custom preview text\npython3 scripts\u002Fvoice-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\u002Fvoice-design.py --gender female --age young --accent american \\\n  --description \"Energetic podcast host\" --save \"MyHost\"\n\n# List all design options\npython3 scripts\u002Fvoice-design.py --options\n```\n\n**Voice Design Options:**\n\n| Option | Values |\n|--------|--------|\n| Gender | male, female, neutral |\n| Age | young, middle_aged, old |\n| Accent | american, british, african, australian, indian, latin, middle_eastern, scandinavian, eastern_european |\n| Accent Strength | 0.3-2.0 (subtle to strong) |\n\n---\n\n## ? Pronunciation Dictionary\n\nCustomize how words are pronounced:\n\nEdit `pronunciations.json`:\n```json\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```bash\n# Pronunciations are applied automatically\npython3 scripts\u002Ftts.py --text \"The OpenClaw API is great\" --voice rachel\n\n# Disable pronunciations\npython3 scripts\u002Ftts.py --text \"The API is great\" --voice rachel --no-pronunciations\n```\n\n---\n\n## ? Cost Tracking\n\nThe skill tracks your character usage and estimates costs:\n\n```bash\npython3 scripts\u002Ftts.py --stats\n```\n\n**Output:**\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\u002F1k chars)\n  Creator    $3.66 ($0.24\u002F1k chars)\n  Pro        $2.74 ($0.18\u002F1k chars)\n  Scale      $1.68 ($0.11\u002F1k chars)\n```\n\n---\n\n## ? OpenClaw TTS Integration\n\n### Using with OpenClaw's Built-in TTS\n\nOpenClaw has built-in TTS support that can use ElevenLabs. Configure in `~\u002F.openclaw\u002Fopenclaw.json`:\n\n```json\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```\n\n### Triggering TTS in Chat\n\nIn OpenClaw conversations:\n- Use `\u002Ftts on` to enable automatic TTS\n- Use the `tts` tool directly for one-off speech\n- Request \"read this aloud\" or \"speak this\"\n\n### Using Skill Scripts from OpenClaw\n\n```bash\n# OpenClaw can run these scripts directly\nexec python3 \u002Fpath\u002Fto\u002Fskills\u002Felevenlabs-voices\u002Fscripts\u002Ftts.py --text \"Hello\" --voice rachel\n```\n\n---\n\n## ⚙️ Configuration\n\nThe scripts look for API key in this order:\n\n1. `ELEVEN_API_KEY` or `ELEVENLABS_API_KEY` environment variable\n2. OpenClaw config (`~\u002F.openclaw\u002Fopenclaw.json` → tts.elevenlabs.apiKey)\n3. Skill-local `.env` file\n\n**Create .env file:**\n```bash\necho 'ELEVEN_API_KEY=your-key-here' > .env\n```\n\n---\n\n## ?️ Voice Settings\n\nEach voice has tuned settings for optimal output:\n\n| Setting | Range | Description |\n|---------|-------|-------------|\n| stability | 0.0-1.0 | Higher = consistent, lower = expressive |\n| similarity_boost | 0.0-1.0 | How closely to match original voice |\n| style | 0.0-1.0 | Exaggeration of speaking style |\n\n---\n\n## ? Triggers\n\n- \"use {voice_name} voice\"\n- \"speak as {persona}\"\n- \"list voices\"\n- \"voice settings\"\n- \"generate sound effect\"\n- \"design a voice\"\n\n---\n\n## ? Files\n\n```\nelevenlabs-voices\u002F\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\u002F\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\u002F\n    └── voice-guide.md    # Voice selection guide\n```\n\n---\n\n## ? Links\n\n- [ElevenLabs](https:\u002F\u002Felevenlabs.io)\n- [API Documentation](https:\u002F\u002Fdocs.elevenlabs.io)\n- [Voice Library](https:\u002F\u002Felevenlabs.io\u002Fvoice-library)\n- [Sound Effects API](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fsound-generation)\n- [Voice Design API](https:\u002F\u002Felevenlabs.io\u002Fdocs\u002Fapi-reference\u002Fvoice-generation)\n\n---\n\n## ? Changelog\n\n### v2.1.0\n- Added interactive setup wizard (`scripts\u002Fsetup.py`)\n- Onboarding guides through API key, voice, language, quality, and budget settings\n- Config stored locally in `config.json` (added to `.gitignore`)\n- Professional, privacy-focused setup experience\n\n### v2.0.0\n- Added 32 language support with `--lang` parameter\n- Added streaming mode with `--stream` flag\n- Added sound effects generation (`sfx.py`)\n- Added batch processing with `--batch` flag\n- Added cost tracking with `--stats` flag\n- Added voice design tool (`voice-design.py`)\n- Added pronunciation dictionary support\n- Added OpenClaw TTS integration documentation\n- Improved error handling and progress output\n",{"name":5,"tags":56,"version":58,"metadata":59,"description":7},[46,45,50,32,57,41,40,42],"audio","2.1.3",{"clawdbot":60},{"requires":61,"primaryEnv":63},{"env":62,"bins":65},[63,64],"ELEVEN_API_KEY","ELEVENLABS_API_KEY",[43],"main","f4cb2d49f7667e79ef7804f50396d5aaffdf1f56","语音与转录\u002Felevenlabs-voices",1,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification","https:\u002F\u002Fgithub.com\u002FKernel8901","a little little little dobe in life but science geek","2026-04-05 16:43:56",{"source":8,"skillName":5,"commands":75,"prompt":85,"zipAvailable":86},[76,79,82],{"tool":77,"command":78},"npx","npx skills add Kernel8901\u002Fai-agent-skills-classification --skill elevenlabs-voices",{"tool":80,"command":81},"bunx","bunx skills add Kernel8901\u002Fai-agent-skills-classification --skill elevenlabs-voices",{"tool":83,"command":84},"pnpm","pnpm dlx skills add Kernel8901\u002Fai-agent-skills-classification --skill elevenlabs-voices","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002FSKILL.md",true,[88,94,98,102,106,110,114,118,124,128,132,136],{"path":89,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":92,"sourceHtmlUrl":93},"_meta.json","REFERENCE","参考文档",1527,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002F_meta.json",{"path":95,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":96,"sourceHtmlUrl":97},"CHANGELOG.md",109,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002FCHANGELOG.md",{"path":99,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":100,"sourceHtmlUrl":101},"examples.md",7492,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fexamples.md",{"path":103,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":104,"sourceHtmlUrl":105},"package.json",652,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fpackage.json",{"path":107,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":108,"sourceHtmlUrl":109},"pronunciations.json",1603,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fpronunciations.json",{"path":111,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":112,"sourceHtmlUrl":113},"README.md",2046,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002FREADME.md",{"path":115,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":116,"sourceHtmlUrl":117},"references\u002Fvoice-guide.md",8006,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Freferences\u002Fvoice-guide.md",{"path":119,"resourceType":120,"resourceTypeDesc":121,"sizeBytes":122,"sourceHtmlUrl":123},"scripts\u002Fsetup.py","SCRIPT","脚本",10507,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fscripts\u002Fsetup.py",{"path":125,"resourceType":120,"resourceTypeDesc":121,"sizeBytes":126,"sourceHtmlUrl":127},"scripts\u002Fsfx.py",9951,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fscripts\u002Fsfx.py",{"path":129,"resourceType":120,"resourceTypeDesc":121,"sizeBytes":130,"sourceHtmlUrl":131},"scripts\u002Ftts.py",7045,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fscripts\u002Ftts.py",{"path":133,"resourceType":120,"resourceTypeDesc":121,"sizeBytes":134,"sourceHtmlUrl":135},"scripts\u002Fvoice-design.py",11842,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fscripts\u002Fvoice-design.py",{"path":137,"resourceType":90,"resourceTypeDesc":91,"sizeBytes":138,"sourceHtmlUrl":139},"voices.json",8062,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F语音与转录\u002Felevenlabs-voices\u002Fvoices.json",[141,165,194,205,215,244],{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":51},"01M6Q5R6WZ06RRB9RQTW54B34B","zyfai","Earn yield on any Ethereum wallet on Base, Arbitrum, and Plasma. Use when a user wants passive DeFi yield on their funds. Deploys a non-custodial subaccount (Safe) linked to their EOA, enables automated yield optimization, and lets them deposit\u002Fwithdraw anytime.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzyfai-sdk\u002FSKILL.md",[],[143,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164],"safe","ethereum","defi","Optimization","user","use","Wallet","base","deposit","withdraw","yield","arbitrum","non-custodial","passive","defi yield","earn","yield optimization",{"skillNo":166,"name":167,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":177,"publishedAt":51},"01M6Q5R337B5JSNER4P4YS03TN","zerion-api","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api\u002FSKILL.md",[170,171,174],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":172,"categoryName":173,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":175,"categoryName":176,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000030","开发工程师",[48,178,179,180,181,182,183,150,184,154,185,186,187,188,189,190,191,192,193],"zerion api","zerion","MCP","mcp server","server","blockchain","transactions","crypto wallet","crypto","evm","solana","query","across","positions","token","prices",{"skillNo":195,"name":196,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":197,"categories":198,"keywords":202,"publishedAt":51},"01M6Q5QZFYTDAZMZ27BN5VZXAR","zerion-api-skill","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api-skill\u002FSKILL.md",[199,200,201],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":172,"categoryName":173,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":175,"categoryName":176,"taxonomyType":28,"taxonomyTypeDesc":29},[48,203,204,178,179,180,181,182,183,150,184,154,186,187,188,189,190,191,192,193],"api skill","zerion api skill",{"skillNo":206,"name":207,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":208,"categories":209,"keywords":213,"publishedAt":51},"01M6Q5QW17QW98RA3FE45E4RD8","zerion-api-mcp","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api-mcp\u002FSKILL.md",[210,211,212],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":172,"categoryName":173,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":175,"categoryName":176,"taxonomyType":28,"taxonomyTypeDesc":29},[180,48,214,178,179,181,182,150,184,154,185,186,187,188,189,190,191,192,193],"zerion api mcp",{"skillNo":216,"name":217,"nameZh":6,"description":218,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":219,"categories":220,"keywords":224,"publishedAt":51},"01M6Q5QQYZB7A501BDEQWKGSJT","yahoo-finance-forex","Fetches real-time FOREX news and market data from Yahoo Finance for major currency pairs (EUR\u002FUSD, GBP\u002FUSD, USD\u002FJPY, etc.). Analyzes sentiment and provides trading context.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fyahoo-finance-forex\u002FSKILL.md",[221],{"categoryNo":222,"categoryName":223,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000040","财务",[225,226,227,228,229,230,231,232,233,43,234,235,236,237,238,239,240,241,242,243],"finance","yahoo finance","forex","yahoo","yahoo finance forex","github","https","sentiment","real-time","install","Market","usd","news","time","currency","gbp","pip","market data","for",{"skillNo":245,"name":246,"nameZh":6,"description":247,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":248,"categories":249,"keywords":251,"publishedAt":51},"01M6Q5QM6VS84WZVM7BKXXPF32","yahoo-finance","This skill should be used when the user asks to \"get stock prices\", \"check stock quotes\", \"look up earnings\", \"get financial data\", \"find trending stocks\", or needs stock market data from Yahoo Finance.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fyahoo-finance-cli\u002FSKILL.md",[250],{"categoryNo":222,"categoryName":223,"taxonomyType":28,"taxonomyTypeDesc":29},[225,226,228,252,253,254,255,256,257,235,258,259,260,261,262,263,264,265,193,242],"cli","homebrew","find","check","brew","up","local","get","stock","link","trending","sf","quotes","ln"]