Introduction
# aliyun-tts
Alibaba Cloud Text-to-Speech synthesis service.
## Configuration
Set the following environment variables: - `ALIYUN_APP_KEY` - Application Key - `ALIYUN_ACCESS_KEY_ID` - Access Key ID - `ALIYUN_ACCESS_KEY_SECRET` - Access Key Secret (sensitive)
### Option 1: CLI configuration (recommended)
```bash # Configure App Key clawdbot skills config aliyun-tts ALIYUN_APP_KEY "your-app-key"
# Configure Access Key ID clawdbot skills config aliyun-tts ALIYUN_ACCESS_KEY_ID "your-access-key-id"
# Configure Access Key Secret (sensitive) clawdbot skills config aliyun-tts ALIYUN_ACCESS_KEY_SECRET "your-access-key-secret" ```
### Option 2: Manual configuration
Edit `~/.clawdbot/clawdbot.json`:
```json5 { skills: { entries: { "aliyun-tts": { env: { ALIYUN_APP_KEY: "your-app-key", ALIYUN_ACCESS_KEY_ID: "your-access-key-id", ALIYUN_ACCESS_KEY_SECRET: "your-access-key-secret" } } } } } ```
## Usage
```bash # Basic usage {baseDir}/bin/aliyun-tts "Hello, this is Aliyun TTS"
# Specify output file {baseDir}/bin/aliyun-tts -o /tmp/voice.mp3 "Hello"
# Specify voice {baseDir}/bin/aliyun-tts -v siyue "Use siyue voice"
# Specify format and sample rate {baseDir}/bin/aliyun-tts -f mp3 -r 16000 "Audio parameters" ```
## Options
| Flag | Description | Default | |------|-------------|---------| | `-o, --output` | Output file path | tts.mp3 | | `-v, --voice` | Voice name | siyue | | `-f, --format` | Audio format | mp3 | | `-r, --sample-rate` | Sample rate | 16000 |
## Available Voices
Common voices: `siyue`, `xiaoxuan`, `xiaoyun`, etc. See Alibaba Cloud documentation for the full list.
## Chat Voice Replies
When a user requests a voice reply:
```bash # Generate audio {baseDir}/bin/aliyun-tts -o /tmp/voice-reply.mp3 "Your reply content"
# Include in your response: # MEDIA:/tmp/voice-reply.mp3 ```