Vai al contenuto principale

​
Vydra

Il plugin Vydra integrato aggiunge:
  • Generazione di immagini tramite vydra/grok-imagine
  • Generazione video tramite vydra/veo3 e vydra/kling
  • Sintesi vocale tramite il percorso TTS di Vydra basato su ElevenLabs
OpenClaw usa la stessa VYDRA_API_KEY per tutte e tre le capacità.
Usa https://www.vydra.ai/api/v1 come URL di base.L’host apex di Vydra (https://vydra.ai/api/v1) al momento reindirizza a www. Alcuni client HTTP eliminano Authorization durante quel reindirizzamento cross-host, trasformando una chiave API valida in un fuorviante errore di autenticazione. Il plugin integrato usa direttamente l’URL di base www per evitare questo problema.

​
Configurazione

1

Esegui l’onboarding interattivo

openclaw onboard --auth-choice vydra-api-key
Oppure imposta direttamente la variabile d’ambiente:
export VYDRA_API_KEY="vydra_live_..."
2

Scegli una capacità predefinita

Scegli una o più delle capacità qui sotto (immagine, video o speech) e applica la configurazione corrispondente.

​
Capacità

Modello immagine predefinito:
  • vydra/grok-imagine
Impostalo come provider di immagini predefinito:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
Il supporto integrato attuale è solo text-to-image. I percorsi di modifica ospitati da Vydra si aspettano URL immagine remoti e OpenClaw non aggiunge ancora nel plugin integrato un bridge di upload specifico per Vydra.
Consulta Image Generation per i parametri condivisi degli strumenti, la selezione del provider e il comportamento di failover.
Modelli video registrati:
  • vydra/veo3 per text-to-video
  • vydra/kling per image-to-video
Imposta Vydra come provider video predefinito:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
Note:
  • vydra/veo3 è integrato solo come text-to-video.
  • vydra/kling al momento richiede un riferimento a un URL immagine remoto. I caricamenti di file locali vengono rifiutati in anticipo.
  • L’attuale percorso HTTP kling di Vydra è stato incoerente sul fatto che richieda image_url o video_url; il provider integrato mappa lo stesso URL immagine remoto in entrambi i campi.
  • Il plugin integrato resta prudente e non inoltra controlli di stile non documentati come aspect ratio, resolution, watermark o audio generato.
Consulta Video Generation per i parametri condivisi degli strumenti, la selezione del provider e il comportamento di failover.
Copertura live specifica del provider:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
Il file live Vydra integrato ora copre:
  • vydra/veo3 text-to-video
  • vydra/kling image-to-video usando un URL immagine remoto
Sostituisci il fixture dell’immagine remota quando necessario:
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
Imposta Vydra come provider speech:
{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          voiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
Valori predefiniti:
  • Modello: elevenlabs/tts
  • ID voce: 21m00Tcm4TlvDq8ikWAM
Il plugin integrato al momento espone una sola voce predefinita nota per funzionare e restituisce file audio MP3.

​
Correlati

Directory dei provider

Sfoglia tutti i provider disponibili.

Generazione di immagini

Parametri condivisi dello strumento immagine e selezione del provider.

Generazione video

Parametri condivisi dello strumento video e selezione del provider.

Riferimento della configurazione

Valori predefiniti degli agenti e configurazione del modello.