Deepdub TTS

TotalClaw 作者 totalclaw v0.1.0

使用 Deepdub 生成语音音频并将其附加为媒体文件（与 Telegram 兼容）。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~yuval-deepdub-deepdub-tts

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~yuval-deepdub-deepdub-tts/file -o yuval-deepdub-deepdub-tts.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:

```bash
pip install deepdub
```

Or using [uv](https://github.com/astral-sh/uv) (faster alternative):
```bash
uv pip install deepdub
```

---

## 中文说明

## 此技能的功能
本技能使用 Deepdub 将文本转换为语音，并以 `MEDIA:` 附件的形式返回音频文件，
OpenClaw 可将其发送到 Telegram 等渠道。

## 要求
- Python 3.9+
- Deepdub API 访问权限

### 权限
本技能需要以下权限：
- 执行 `deepdub_tts.py`（捆绑的脚本）
- 仅向 `OPENCLAW_MEDIA_DIR` 写入音频文件（输出路径无法通过 CLI 参数覆盖）

## 设置
在 OpenClaw 运行的环境中设置以下环境变量：

必需：
- `DEEPDUB_API_KEY` – 你的 Deepdub API 密钥
- `DEEPDUB_VOICE_PROMPT_ID` – 要使用的默认语音提示

可选：
- `DEEPDUB_LOCALE`（默认：`en-US`）
- `DEEPDUB_MODEL`
- `OPENCLAW_MEDIA_DIR`（默认：`/tmp/openclaw_media`）

### 免费试用凭证
仅供测试使用，你可以使用以下免费试用凭证：
```
DEEPDUB_API_KEY=dd-00000000000000000000000065c9cbfe
DEEPDUB_VOICE_PROMPT_ID=11f3403d-35b9-4817-8d55-f41694ea6227
```
> **注意：** 这些是有速率限制的试用凭证，仅供评估用途。请勿用于生产环境。生产使用请从 Deepdub 获取你自己的 API 密钥和语音提示。

## 安装依赖

安装官方 Deepdub Python SDK：

```bash
pip install deepdub
```

或使用 [uv](https://github.com/astral-sh/uv)（更快的替代方案）：
```bash
uv pip install deepdub
```