Files
stef-openclaw-skills/docs/elevenlabs-stt.md
2026-03-08 21:11:09 -05:00

42 lines
1.0 KiB
Markdown

# elevenlabs-stt
Transcribe local audio files with ElevenLabs Speech-to-Text.
## What this skill is for
- Local audio transcription
- Voice note transcription
- Optional speaker diarization
- Language hints and event tagging
- JSON output for programmatic use
## Requirements
Required binaries:
- `curl`
- `jq`
- `python3`
Preferred auth:
- `ELEVENLABS_API_KEY` in the environment
Fallback auth:
- local OpenClaw config lookup from `~/.openclaw/openclaw.json` or `~/.openclaw/secrets.json`
## Wrapper
Use the bundled script directly:
```bash
bash skills/elevenlabs-stt/scripts/transcribe.sh /path/to/audio.mp3
bash skills/elevenlabs-stt/scripts/transcribe.sh /path/to/audio.mp3 --diarize --lang en
bash skills/elevenlabs-stt/scripts/transcribe.sh /path/to/audio.mp3 --json
bash skills/elevenlabs-stt/scripts/transcribe.sh /path/to/audio.mp3 --events
```
## Notes
- Uses ElevenLabs STT model `scribe_v2`.
- Uploads a local file directly to ElevenLabs.
- If `ELEVENLABS_API_KEY` is not exported, the script tries local OpenClaw config/secrets automatically.