# Send Voice.ai Voices to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "voice-ai-voices", "name": "Voice.ai Voices", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/gizmoGremlin/voice-ai-voices", "canonicalUrl": "https://clawhub.ai/gizmoGremlin/voice-ai-voices", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/voice-ai-voices", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-ai-voices", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "LICENSE.md", "README.md", "SECURITY.md", "SKILL.md", "package.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-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/voice-ai-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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/voice-ai-voices", "downloadUrl": "https://openagent3.xyz/downloads/voice-ai-voices", "agentUrl": "https://openagent3.xyz/skills/voice-ai-voices/agent", "manifestUrl": "https://openagent3.xyz/skills/voice-ai-voices/agent.json", "briefUrl": "https://openagent3.xyz/skills/voice-ai-voices/agent.md" } } ``` ## Documentation ### ✨ Features 9 Voice Personas - Carefully curated voices for different use cases 11 Languages - Multi-language synthesis with multilingual model Streaming Mode - Real-time audio output as it generates Voice Design - Customize with temperature and top_p parameters OpenClaw Integration - Works with OpenClaw's built-in TTS ### ⚙️ Configuration Set your API key as an environment variable: export VOICE_AI_API_KEY="your-api-key" Get your API key: Voice.ai Dashboard ### 📦 Installation No install step is required. This skill bundles a Node.js CLI and SDK (no external npm dependencies). ### 🧩 Key Files scripts/tts.js - CLI entrypoint voice-ai-tts-sdk.js - Node.js SDK used by the CLI voices.json - Voice definitions used by the CLI voice-ai-tts.yaml - API specification package.json - Skill metadata for tooling ### Security Notes See SECURITY.md for the full security and privacy overview. This skill: Makes outbound HTTPS requests only to https://dev.voice.ai Reads local files: voices.json Writes audio output to the --output path (default output.mp3) Does not execute shell commands and does not modify system configuration files ### 🌐 API Endpoint The SDK and spec use https://dev.voice.ai, which is the official Voice.ai production API domain. ### 🤖 OpenClaw Integration OpenClaw can invoke the CLI script directly if your environment exposes VOICE_AI_API_KEY. Use the /tts commands as configured by your OpenClaw installation. ### 📝 Triggers These chat commands work with OpenClaw: CommandDescription/tts Generate speech with default voice/tts --voice ellie Generate speech with specific voice/tts --stream Generate with streaming mode/voicesList available voices Examples: /tts Hello, welcome to Voice.ai! /tts --voice oliver Good morning, everyone. /tts --voice lilith --stream This is a long story that will stream as it generates... ### 🎙️ Available Voices VoiceIDGenderPersonaBest Forellied1bf0f33-8e0e-4fbf-acf8-45c3c6262513femaleyouthfulVlogs, social contentoliverf9e6a5eb-a7fd-4525-9e92-75125249c933malebritishNarration, tutorialslilith4388040c-8812-42f4-a264-f457a6b2b5b9femalesoftASMR, calm contentsmoothdbb271df-db25-4225-abb0-5200ba1426bcmaledeepDocumentaries, audiobooksshadow72d2a864-b236-402e-a166-a838ccc2c273maledistinctiveGaming, entertainmentsakura559d3b72-3e79-4f11-9b62-9ec702a6c057femaleanimeCharacter voiceszenithed751d4d-e633-4bb0-8f5e-b5c8ddb04402maledeepGaming, dramatic contentfloraa931a6af-fb01-42f0-a8c0-bd14bc302bb1femalecheerfulKids content, upbeatcommanderbd35e4e6-6283-46b9-86b6-7cfa3dd409b9maleheroicGaming, action content ### 🌍 Supported Languages CodeLanguageenEnglishesSpanishfrFrenchdeGermanitItalianptPortugueseplPolishruRussiannlDutchsvSwedishcaCatalan Use the multilingual model for non-English languages: const audio = await client.generateSpeech({ text: 'Bonjour le monde!', voice_id: 'ellie-voice-id', model: 'voiceai-tts-multilingual-v1-latest', language: 'fr' }); ### 🎨 Voice Design Customize voice output with these parameters: ParameterRangeDefaultDescriptiontemperature0-21.0Higher = more expressive, lower = more consistenttop_p0-10.8Controls randomness in speech generation Example: const audio = await client.generateSpeech({ text: 'This will sound very expressive!', voice_id: 'ellie-voice-id', temperature: 1.8, top_p: 0.9 }); ### 📡 Streaming Mode Generate audio with real-time streaming (recommended for long texts): # Stream audio as it generates node scripts/tts.js --text "This is a long story..." --voice ellie --stream # Streaming with custom output node scripts/tts.js --text "Chapter one..." --voice oliver --stream --output chapter1.mp3 SDK streaming: const stream = await client.streamSpeech({ text: 'Long text here...', voice_id: 'ellie-voice-id' }); // Pipe to file stream.pipe(fs.createWriteStream('output.mp3')); // Or handle chunks stream.on('data', chunk => { // Process audio chunk }); ### 🔊 Audio Formats FormatDescriptionUse Casemp3Standard MP3 (32kHz)General usewavUncompressed WAVHigh qualitypcmRaw PCM audioProcessingopus_48000_128Opus 128kbpsStreamingmp3_44100_192High-quality MP3Professional See voice-ai-tts-sdk.js for all format options. ### 💻 CLI Usage # Set API key export VOICE_AI_API_KEY="your-key-here" # Generate speech node scripts/tts.js --text "Hello world!" --voice ellie # Choose different voice node scripts/tts.js --text "Good morning!" --voice oliver --output morning.mp3 # Use streaming for long texts node scripts/tts.js --text "Once upon a time..." --voice lilith --stream # Show help node scripts/tts.js --help ### 📁 Files voice-ai-tts/ ├── SKILL.md # This documentation ├── README.md # Quick start ├── CHANGELOG.md # Version history ├── LICENSE.md # MIT license ├── SECURITY.md # Security & privacy notes ├── voices.json # Voice definitions ├── voice-ai-tts.yaml # OpenAPI specification ├── voice-ai-tts-sdk.js # JavaScript/Node.js SDK ├── package.json # OpenClaw metadata ├── scripts/ │ └── tts.js # CLI tool ### 💰 Cost & Usage Voice.ai uses a credit-based system. Check your usage: // The SDK tracks usage via API responses const voices = await client.listVoices(); // Check response headers for rate limit info Tips to reduce costs: Use streaming for long texts (more efficient) Cache generated audio when possible Use appropriate audio quality for your use case ### 🔗 Links Get API Key - Sign up and get your key API Documentation - Full API reference Voice Library - Browse all voices API Reference - Endpoint details Pricing - Plans and credits ### v1.1.5 (2026-02-16) Declare runtime requirements via metadata.clawdbot so ClawHub shows required env vars ### v1.1.4 (2026-02-16) Declare VOICE_AI_API_KEY as primary env var in metadata ### v1.1.3 (2026-02-16) Remove voice-sample upload features from the published bundle to reduce privacy risk Require VOICE_AI_API_KEY via environment variable only ### v1.1.2 (2026-02-16) Added SECURITY.md and LICENSE.md for provenance and transparency Restricted SDK transport to HTTPS only ### v1.1.1 (2026-02-16) Packaging metadata improvements for ClawHub import (bin/files metadata) ### v1.1.0 (2026-02-16) Declared required credentials in metadata Documented the production API endpoint domain Renamed voice personas for IP-safe labeling Added voices.json for voice data ### v1.0.0 (2025-01-31) Initial release 9 curated voice personas 11 language support Streaming mode Voice design parameters Full SDK with error handling CLI tool ### 🛠️ SDK Quick Reference const VoiceAI = require('./voice-ai-tts-sdk'); const client = new VoiceAI(process.env.VOICE_AI_API_KEY); // List voices const voices = await client.listVoices({ limit: 10 }); // Get voice details const voice = await client.getVoice('voice-id'); // Generate speech const audio = await client.generateSpeech({ text: 'Hello, world!', voice_id: 'voice-id', audio_format: 'mp3' }); // Generate to file await client.generateSpeechToFile( { text: 'Hello!', voice_id: 'voice-id' }, 'output.mp3' ); // Stream speech const stream = await client.streamSpeech({ text: 'Long text...', voice_id: 'voice-id' }); // Delete voice await client.deleteVoice('voice-id'); ### ❓ Troubleshooting ErrorCauseSolutionAuthenticationErrorInvalid API keyCheck your VOICE_AI_API_KEYPaymentRequiredErrorOut of creditsAdd credits at voice.ai/dashboardRateLimitErrorToo many requestsWait and retry, or upgrade planValidationErrorInvalid parametersCheck text length and voice_id Made with ❤️ by Nick Gill ## Trust - Source: tencent - Verification: Indexed source record - Publisher: gizmoGremlin - Version: 1.1.5 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/voice-ai-voices) - [Send to Agent page](https://openagent3.xyz/skills/voice-ai-voices/agent) - [JSON manifest](https://openagent3.xyz/skills/voice-ai-voices/agent.json) - [Markdown brief](https://openagent3.xyz/skills/voice-ai-voices/agent.md) - [Download page](https://openagent3.xyz/downloads/voice-ai-voices)