Pular para o conteúdo principal

​
Vydra

O plugin Vydra integrado adiciona:
  • Geração de imagem via vydra/grok-imagine
  • Geração de vídeo via vydra/veo3 e vydra/kling
  • Síntese de fala pela rota de TTS da Vydra com tecnologia ElevenLabs
O OpenClaw usa a mesma VYDRA_API_KEY para as três capacidades.
Use https://www.vydra.ai/api/v1 como URL base.O host apex da Vydra (https://vydra.ai/api/v1) atualmente redireciona para www. Alguns clientes HTTP descartam Authorization nesse redirecionamento entre hosts, o que transforma uma chave de API válida em uma falha de autenticação enganosa. O plugin integrado usa diretamente a URL base com www para evitar isso.

​
Configuração

1

Execute o onboarding interativo

openclaw onboard --auth-choice vydra-api-key
Ou defina a variável de ambiente diretamente:
export VYDRA_API_KEY="vydra_live_..."
2

Escolha uma capacidade padrão

Escolha uma ou mais das capacidades abaixo (imagem, vídeo ou fala) e aplique a configuração correspondente.

​
Capacidades

Modelo de imagem padrão:
  • vydra/grok-imagine
Defina-o como o provedor de imagem padrão:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
O suporte integrado atual é apenas para texto para imagem. As rotas hospedadas de edição da Vydra esperam URLs remotas de imagem, e o OpenClaw ainda não adiciona uma bridge de upload específica da Vydra no plugin integrado.
Veja Geração de imagem para parâmetros compartilhados da ferramenta, seleção de provedor e comportamento de failover.
Modelos de vídeo registrados:
  • vydra/veo3 para texto para vídeo
  • vydra/kling para imagem para vídeo
Defina a Vydra como provedor de vídeo padrão:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
Observações:
  • vydra/veo3 está integrado apenas como texto para vídeo.
  • vydra/kling atualmente exige uma URL remota de imagem como referência. Uploads de arquivos locais são rejeitados antecipadamente.
  • A rota HTTP atual kling da Vydra tem sido inconsistente sobre exigir image_url ou video_url; o provedor integrado mapeia a mesma URL remota de imagem para ambos os campos.
  • O plugin integrado permanece conservador e não encaminha controles de estilo não documentados, como proporção, resolução, marca-d’água ou áudio gerado.
Veja Geração de vídeo para parâmetros compartilhados da ferramenta, seleção de provedor e comportamento de failover.
Cobertura live específica do provedor:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
O arquivo live integrado da Vydra agora cobre:
  • vydra/veo3 texto para vídeo
  • vydra/kling imagem para vídeo usando uma URL remota de imagem
Substitua o fixture de imagem remota quando necessário:
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
Defina a Vydra como provedor de fala:
{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          voiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
Padrões:
  • Modelo: elevenlabs/tts
  • ID da voz: 21m00Tcm4TlvDq8ikWAM
O plugin integrado atualmente expõe uma única voz padrão conhecida por funcionar e retorna arquivos de áudio MP3.

​
Relacionado

Diretório de provedores

Navegue por todos os provedores disponíveis.

Geração de imagem

Parâmetros compartilhados da ferramenta de imagem e seleção de provedor.

Geração de vídeo

Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.

Referência de configuração

Padrões de agente e configuração de modelo.