Перейти к основному содержанию
Встроенный Plugin Vydra добавляет:
  • Генерацию изображений через vydra/grok-imagine
  • Генерацию видео через vydra/veo3 и vydra/kling
  • Синтез речи через маршрут TTS Vydra на базе ElevenLabs
OpenClaw использует один и тот же VYDRA_API_KEY для всех трех возможностей.
СвойствоЗначение
Идентификатор провайдераvydra
Pluginвстроенный, enabledByDefault: true
Переменная окружения для аутентификацииVYDRA_API_KEY
Флаг онбординга--auth-choice vydra-api-key
Прямой флаг CLI--vydra-api-key <key>
КонтрактыimageGenerationProviders, videoGenerationProviders, speechProviders
Базовый URLhttps://www.vydra.ai/api/v1 (используйте хост www)
Используйте https://www.vydra.ai/api/v1 как базовый URL. Apex-хост Vydra (https://vydra.ai/api/v1) сейчас перенаправляет на www. Некоторые HTTP-клиенты удаляют Authorization при таком межхостовом перенаправлении, из-за чего действительный API-ключ выглядит как вводящая в заблуждение ошибка аутентификации. Встроенный Plugin напрямую использует базовый URL с www, чтобы избежать этого.

​
Настройка

1

Run interactive onboarding

openclaw onboard --auth-choice vydra-api-key
Или задайте переменную окружения напрямую:
export VYDRA_API_KEY="vydra_live_..."
2

Choose a default capability

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

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

Модель изображений по умолчанию:
  • vydra/grok-imagine
Задайте ее как провайдера изображений по умолчанию:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
Текущая встроенная поддержка включает только преобразование текста в изображение. Размещенные маршруты редактирования Vydra ожидают удаленные URL изображений, а OpenClaw пока не добавляет во встроенный Plugin специальный мост загрузки для Vydra.
См. Генерация изображений для общих параметров инструмента, выбора провайдера и поведения при отказе.
Зарегистрированные модели видео:
  • vydra/veo3 для преобразования текста в видео
  • vydra/kling для преобразования изображения в видео
Задайте Vydra как провайдера видео по умолчанию:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
Примечания:
  • vydra/veo3 встроена только для преобразования текста в видео.
  • vydra/kling сейчас требует ссылку на удаленный URL изображения. Загрузки локальных файлов отклоняются заранее.
  • Текущий HTTP-маршрут kling у Vydra ведет себя непоследовательно в том, требует ли он image_url или video_url; встроенный провайдер отображает один и тот же удаленный URL изображения в оба поля.
  • Встроенный Plugin остается консервативным и не передает недокументированные параметры стиля, такие как соотношение сторон, разрешение, водяной знак или сгенерированный звук.
См. Генерация видео для общих параметров инструмента, выбора провайдера и поведения при отказе.
Live-покрытие для конкретного провайдера:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
Встроенный live-файл Vydra теперь покрывает:
  • преобразование текста в видео vydra/veo3
  • преобразование изображения в видео vydra/kling с использованием удаленного URL изображения
При необходимости переопределите удаленную фикстуру изображения:
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
Задайте Vydra как провайдера речи:
{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          speakerVoiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
Значения по умолчанию:
  • Модель: elevenlabs/tts
  • Идентификатор голоса: 21m00Tcm4TlvDq8ikWAM
Встроенный Plugin сейчас предоставляет один проверенный голос по умолчанию и возвращает аудиофайлы MP3.

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

Provider directory

Просмотрите всех доступных провайдеров.

Image generation

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

Video generation

Общие параметры инструмента видео и выбор провайдера.

Configuration reference

Значения по умолчанию для агентов и конфигурация моделей.