OpenClawDocs
On this page

On this page

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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-provider

    Installation applies to a running Gateway automatically; otherwise it takes effect on the next startup. See Apply changes and inspect.

  • 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.

    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.
    Was this useful?