← Back to Skills Marketplace
yuval-deepdub

Deepdub TTS

by yuval-deepdub · GitHub ↗ · v0.1.5
cross-platform ✓ Security Clean
1874
Downloads
9
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install deepdub-tts
Description
Generate speech audio using Deepdub and attach it as a MEDIA file (Telegram-compatible).
README (SKILL.md)

What this skill does

This skill converts text into speech using Deepdub and returns an audio file as a MEDIA: attachment that OpenClaw can send to channels like Telegram.

Requirements

  • Python 3.9+
  • Deepdub API access

Permissions

This skill requires permission to:

  • Execute deepdub_tts.py (the bundled script)
  • Write audio files to OPENCLAW_MEDIA_DIR only (output path cannot be overridden via CLI arguments)

Setup

Set the following environment variables where OpenClaw runs:

Required:

  • DEEPDUB_API_KEY – your Deepdub API key
  • DEEPDUB_VOICE_PROMPT_ID – default voice prompt to use

Optional:

  • DEEPDUB_LOCALE (default: en-US)
  • DEEPDUB_MODEL
  • OPENCLAW_MEDIA_DIR (default: /tmp/openclaw_media)

Free Trial Credentials

For testing only, you can use these free trial credentials:

DEEPDUB_API_KEY=dd-00000000000000000000000065c9cbfe
DEEPDUB_VOICE_PROMPT_ID=11f3403d-35b9-4817-8d55-f41694ea6227

Note: These are rate-limited trial credentials for evaluation purposes only. Do not use for production. Obtain your own API key and voice prompts from Deepdub for production use.

Install dependency

Install the official Deepdub Python SDK:

pip install deepdub

Or using uv (faster alternative):

uv pip install deepdub
Usage Guidance
This skill appears to do what it says: it uses the Deepdub Python SDK to synthesize text into an MP3 and returns a MEDIA: path. Before installing: (1) obtain and set your own DEEPDUB_API_KEY (do not rely on the trial key included in the docs), (2) avoid passing sensitive or private text to the TTS API because text is sent to Deepdub, (3) install the deepdub package in an isolated environment (venv/container) or audit it first since pip installs execute third-party code, and (4) if you do not want the agent to call this skill autonomously, disable model invocation or restrict invocation in your OpenClaw settings. Overall the skill is internally consistent with low risk if you follow these precautions.
Capability Analysis
Type: OpenClaw Skill Name: deepdub-tts Version: 0.1.5 The skill is designed to convert text to speech using the Deepdub API. All accessed environment variables (`DEEPDUB_API_KEY`, `DEEPDUB_VOICE_PROMPT_ID`, `OPENCLAW_MEDIA_DIR`) are directly relevant to its stated purpose. The `deepdub_tts.py` script writes audio files only to the `OPENCLAW_MEDIA_DIR` (controlled by environment variable, not user input), preventing arbitrary file writes. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts in `SKILL.md`. The code is clear, straightforward, and aligns perfectly with its described functionality.
Capability Assessment
Purpose & Capability
Name/description, required env vars (DEEPDUB_API_KEY, DEEPDUB_VOICE_PROMPT_ID), required binary (python3), requirements.txt, SKILL.md pip install deepdub, and deepdub_tts.py all align: the skill needs the Deepdub SDK and an API key to synthesize speech.
Instruction Scope
SKILL.md instructs running the bundled deepdub_tts.py which only reads the declared env vars and writes output to OPENCLAW_MEDIA_DIR. The script prints the expected MEDIA: path for OpenClaw. It does not read unrelated files or environment variables.
Install Mechanism
There is no packaged installer (instruction-only). The docs instruct pip install deepdub (or an alternative 'uv pip install'), which is expected but means a third-party Python package will be downloaded/executed at install time — normal for this use but worth auditing or isolating before installing globally.
Credentials
The skill only requests the Deepdub API key and a voice prompt ID (plus optional locale/model and output dir) which are proportionate. A cautionary note: SKILL.md includes a public rate-limited trial API key — do not use it in production. Also avoid sending sensitive/personal data to the Deepdub API.
Persistence & Privilege
The skill does not request permanent 'always' inclusion, does not modify other skills or system configs, and only writes audio files to the specified media dir. Autonomous invocation of skills is the platform default and is not unusual here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install deepdub-tts
  3. After installation, invoke the skill by name or use /deepdub-tts
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
- Updated SKILL.md to include a trial DEEPDUB_VOICE_PROMPT_ID alongside the trial API key for easier testing. - Clarified the note about trial credentials and recommended obtaining both API key and voice prompts for production use. - No code or functional changes; documentation only.
v0.1.4
- Added package.json for npm support and metadata management. - Updated SKILL.md format to include structured metadata and improved compatibility notes.
v0.1.3
- Added author, homepage, and repository fields to the skill metadata. - Updated SDK installation instructions: now pip is listed first, with uv as an alternative. - Minor formatting and organizational improvements in the installation section.
v0.1.2
- Added explicit listing of required and optional environment variables in the skill metadata. - Clarified that the audio output path cannot be overridden via CLI arguments for security. - Updated the free trial key section with a warning against production use. - Improved installation instructions with clearer mention of the official Deepdub SDK. - Minor rewording and formatting improvements for clarity and consistency.
v0.1.1
- Added a LICENSE file to clarify the project's licensing terms. - Updated documentation to include a free trial Deepdub API key for testing. - Expanded requirements and setup sections for clarity, including specifying permissions needed by the skill. - Provided installation instructions for both uv and pip.
v0.1.0
Initial release of Deepdub TTS skill. - Converts text to speech audio using Deepdub's API. - Returns audio as a MEDIA file, compatible with Telegram channels. - Requires Deepdub API key and voice prompt ID. - Supports optional customization for locale, model, and output directory. - Designed to run with Python 3.9+ and OpenClaw's local command execution.
Metadata
Slug deepdub-tts
Version 0.1.5
License
All-time Installs 1
Active Installs 1
Total Versions 6
Frequently Asked Questions

What is Deepdub TTS?

Generate speech audio using Deepdub and attach it as a MEDIA file (Telegram-compatible). It is an AI Agent Skill for Claude Code / OpenClaw, with 1874 downloads so far.

How do I install Deepdub TTS?

Run "/install deepdub-tts" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Deepdub TTS free?

Yes, Deepdub TTS is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Deepdub TTS support?

Deepdub TTS is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Deepdub TTS?

It is built and maintained by yuval-deepdub (@yuval-deepdub); the current version is v0.1.5.

💬 Comments