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

Providers

Vydra

Встроенный плагин Vydra добавляет:

  • Генерацию изображений через vydra/grok-imagine
  • Генерацию видео через vydra/veo3 (из текста в видео) и vydra/kling (из изображения в видео)
  • Синтез речи через маршрут TTS Vydra на базе ElevenLabs

OpenClaw использует один и тот же VYDRA_API_KEY для всех трёх возможностей.

Свойство Значение
Идентификатор провайдера vydra
Плагин встроенный, enabledByDefault: true
Переменная среды для аутентификации VYDRA_API_KEY
Флаг первоначальной настройки --auth-choice vydra-api-key
Прямой флаг CLI --vydra-api-key <key>
Контракты imageGenerationProviders, videoGenerationProviders, speechProviders
Базовый URL https://www.vydra.ai/api/v1 (используйте хост www)

Настройка

  • Запустите интерактивную первоначальную настройку

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

    Или задайте переменную среды напрямую:

    bash
    export VYDRA_API_KEY="vydra_live_..."

  • Выберите возможность по умолчанию

    Выберите одну или несколько возможностей ниже (изображения, видео или речь) и примените соответствующую конфигурацию.

    • Возможности

    Генерация изображений

    Единственная встроенная модель изображений, используемая по умолчанию:

    • vydra/grok-imagine

    Установите её в качестве провайдера изображений по умолчанию:

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

    Встроенная поддержка охватывает только преобразование текста в изображение и позволяет создать не более одного изображения за запрос. Размещённые у Vydra маршруты редактирования ожидают удалённые URL изображений, а встроенный плагин не добавляет специальный для Vydra механизм загрузки.

    Генерация видео

    Зарегистрированные модели видео:

    • vydra/veo3 для преобразования текста в видео (отклоняет входные ссылки на изображения)
    • vydra/kling для преобразования изображения в видео (требует ровно один удалённый URL изображения)

    Установите Vydra в качестве провайдера видео по умолчанию:

    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "vydra/veo3",      },    },  },}

    Примечания:

    • vydra/kling сразу отклоняет загрузку локальных файлов; поддерживается только ссылка на удалённый URL изображения.
    • HTTP-маршрут Vydra kling непоследовательно требует то image_url, то video_url; встроенный провайдер отправляет один и тот же удалённый URL изображения в обоих полях.
    • Встроенный плагин придерживается консервативного подхода и не передаёт недокументированные параметры стиля, такие как соотношение сторон, разрешение, водяной знак или сгенерированный звук.
    Интерактивные тесты видео

    Интерактивное тестовое покрытие для конкретного провайдера:

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

    Встроенный файл интерактивных тестов Vydra охватывает:

    • vydra/veo3 — преобразование текста в видео
    • vydra/kling — преобразование изображения в видео с использованием удалённого URL изображения

    При необходимости переопределите удалённое тестовое изображение:

    bash
    export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
    Синтез речи

    Установите Vydra в качестве провайдера речи:

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

    Значения по умолчанию:

    • Модель: elevenlabs/tts
    • Идентификатор голоса: 21m00Tcm4TlvDq8ikWAM («Rachel»)

    Встроенный плагин предоставляет этот единственный проверенный голос по умолчанию и возвращает аудиофайлы MP3.

    Связанные материалы

    Каталог провайдеров

    Просмотрите всех доступных провайдеров.
    Генерация изображений

    Общие параметры инструмента для изображений и выбор провайдера.
    Генерация видео

    Общие параметры инструмента для видео и выбор провайдера.
    Справочник по конфигурации

    Значения агента по умолчанию и конфигурация модели.
    Was this useful?
    On this page

    On this page