Providers

Vydra

The official 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.

Property Value
Provider id vydra
Plugin @openclaw/vydra-provider
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

  • Install the plugin

    bash
    openclaw plugins install @openclaw/vydra-provideropenclaw gateway restart
  • Run interactive onboarding

    bash
    openclaw onboard --auth-choice vydra-api-key

    Or set the env var directly:

    bash
    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 and only Vydra image model:

    • vydra/grok-imagine

    Set it as the default image provider:

    json5
    {  agents: {    defaults: {      mediaModels: {        image: {          primary: "vydra/grok-imagine",        },      },    },  },}

    Vydra support is text-to-image only, at most one image per request. Vydra's hosted edit routes expect remote image URLs, and the plugin does not add a Vydra-specific upload bridge.

    Video generation

    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:

    json5
    {  agents: {    defaults: {      mediaModels: {        video: {          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 plugin sends the same remote image URL in both fields.
    • The 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:

    bash
    OPENCLAW_LIVE_TEST=1 \OPENCLAW_LIVE_VYDRA_VIDEO=1 \pnpm test:live -- extensions/vydra/vydra.live.test.ts

    The 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:

    bash
    export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
    Speech synthesis

    Set Vydra as the speech provider:

    json5
    {  tts: {    provider: "vydra",    providers: {      vydra: {        apiKey: "${VYDRA_API_KEY}",        voiceId: "21m00Tcm4TlvDq8ikWAM",      },    },  },}

    Defaults:

    • Model: elevenlabs/tts
    • Voice id: 21m00Tcm4TlvDq8ikWAM ("Rachel")

    The plugin exposes this one known-good default voice and returns MP3 audio files.

    Was this useful?
    On this page

    On this page