Providers
Vydra
The bundled Vydra plugin adds:
- Image generation via
vydra/grok-imagine - Video generation via
vydra/veo3andvydra/kling - Speech synthesis via Vydra's ElevenLabs-backed TTS route
OpenClaw uses the same VYDRA_API_KEY for all three capabilities.
| Property | Value |
|---|---|
| Provider id | vydra |
| Plugin | bundled, enabledByDefault: true |
| Auth env var | VYDRA_API_KEY |
| Onboarding flag | --auth-choice vydra-api-key |
| Direct CLI flag | --vydra-api-key <key> |
| Contracts | imageGenerationProviders, videoGenerationProviders, speechProviders |
| Base URL | https://www.vydra.ai/api/v1 (use the www host) |
Setup
Run interactive onboarding
openclaw onboard --auth-choice vydra-api-key
Or set the env var directly:
export VYDRA_API_KEY="vydra_live_..."
Choose a default capability
Pick one or more of the capabilities below (image, video, or speech) and apply the matching configuration.
Capabilities
Image generation
Default image model:
vydra/grok-imagine
Set it as the default image provider:
{
agents: {
defaults: {
imageGenerationModel: {
primary: "vydra/grok-imagine",
},
},
},
}
Current bundled support is text-to-image only. Vydra's hosted edit routes expect remote image URLs, and OpenClaw does not add a Vydra-specific upload bridge in the bundled plugin yet.
Video generation
Registered video models:
vydra/veo3for text-to-videovydra/klingfor image-to-video
Set Vydra as the default video provider:
{
agents: {
defaults: {
videoGenerationModel: {
primary: "vydra/veo3",
},
},
},
}
Notes:
vydra/veo3is bundled as text-to-video only.vydra/klingcurrently requires a remote image URL reference. Local file uploads are rejected up front.- Vydra's current
klingHTTP route has been inconsistent about whether it requiresimage_urlorvideo_url; the bundled provider maps the same remote image URL into both fields. - The bundled plugin stays conservative and does not forward undocumented style knobs such as aspect ratio, resolution, watermark, or generated audio.
Video live tests
Provider-specific live coverage:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
The bundled Vydra live file now covers:
vydra/veo3text-to-videovydra/klingimage-to-video using a remote image URL
Override the remote image fixture when needed:
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
Speech synthesis
Set Vydra as the speech provider:
{
messages: {
tts: {
provider: "vydra",
providers: {
vydra: {
apiKey: "${VYDRA_API_KEY}",
voiceId: "21m00Tcm4TlvDq8ikWAM",
},
},
},
},
}
Defaults:
- Model:
elevenlabs/tts - Voice id:
21m00Tcm4TlvDq8ikWAM
The bundled plugin currently exposes one known-good default voice and returns MP3 audio files.