Skip to main content
The bundled Vydra plugin adds:
  • Image generation via vydra/grok-imagine
  • Video generation via vydra/veo3 (text-to-video) and vydra/kling (image-to-video)
  • Speech synthesis via Vydra’s ElevenLabs-backed TTS route
OpenClaw uses the same VYDRA_API_KEY for all three capabilities.
PropertyValue
Provider idvydra
Pluginbundled, enabledByDefault: true
Auth env varVYDRA_API_KEY
Onboarding flag--auth-choice vydra-api-key
Direct CLI flag--vydra-api-key <key>
ContractsimageGenerationProviders, videoGenerationProviders, speechProviders
Base URLhttps://www.vydra.ai/api/v1 (use the www host)
Use https://www.vydra.ai/api/v1 as the base URL. Vydra’s apex host (https://vydra.ai/api/v1) currently redirects to www. Some HTTP clients drop Authorization on that cross-host redirect, which turns a valid API key into a misleading auth failure. The bundled plugin normalizes any configured vydra.ai base URL to www.vydra.ai to avoid that.

​
Setup

1

Run interactive onboarding

openclaw onboard --auth-choice vydra-api-key
Or set the env var directly:
export VYDRA_API_KEY="vydra_live_..."
2

Choose a default capability

Pick one or more of the capabilities below (image, video, or speech) and apply the matching configuration.

​
Capabilities

Default and only bundled image model:
  • vydra/grok-imagine
Set it as the default image provider:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
Bundled support is text-to-image only, at most one image per request. Vydra’s hosted edit routes expect remote image URLs, and the bundled plugin does not add a Vydra-specific upload bridge.
See Image Generation for shared tool parameters, provider selection, and failover behavior.
Registered video models:
  • vydra/veo3 for text-to-video (rejects image reference inputs)
  • vydra/kling for image-to-video (requires exactly one remote image URL)
Set Vydra as the default video provider:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
Notes:
  • vydra/kling rejects local file uploads up front; only a remote image URL reference works.
  • Vydra’s kling HTTP route has been inconsistent about whether it requires image_url or video_url; the bundled provider sends the same remote image URL in both fields.
  • The bundled plugin stays conservative and does not forward undocumented style knobs such as aspect ratio, resolution, watermark, or generated audio.
See Video Generation for shared tool parameters, provider selection, and failover behavior.
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 covers:
  • vydra/veo3 text-to-video
  • vydra/kling image-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"
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 (“Rachel”)
The bundled plugin exposes this one known-good default voice and returns MP3 audio files.

Provider directory

Browse all available providers.

Image generation

Shared image tool parameters and provider selection.

Video generation

Shared video tool parameters and provider selection.

Configuration reference

Agent defaults and model configuration.