快速开始
Vydra
内置的 Vydra 插件添加：
- 通过
vydra/grok-imagine生成图像 - 通过
vydra/veo3（文本转视频）和vydra/kling（图像转视频）生成视频 - 通过 Vydra 基于 ElevenLabs 的 TTS 路由进行语音合成
OpenClaw 对这三项能力都使用同一个 VYDRA_API_KEY。
| 属性 | 值 |
|---|---|
| 提供商 ID | 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 主机） |
设置
运行交互式新手引导
openclaw onboard --auth-choice vydra-api-key或者直接设置环境变量：
export VYDRA_API_KEY="vydra_live_..."选择默认能力
选择下面的一项或多项能力（图像、视频或语音），并应用对应配置。
能力
图像生成
默认且唯一内置的图像模型：
vydra/grok-imagine
将它设置为默认图像提供商：
{ agents: { defaults: { imageGenerationModel: { primary: "vydra/grok-imagine", }, }, },}内置支持仅限文本转图像，每个请求最多生成一张图像。Vydra 的托管编辑路由需要远程图像 URL，内置插件不会添加 Vydra 专用的上传桥接。
视频生成
已注册的视频模型：
vydra/veo3用于文本转视频（拒绝图像引用输入）vydra/kling用于图像转视频（需要且仅需要一个远程图像 URL）
将 Vydra 设置为默认视频提供商：
{ agents: { defaults: { videoGenerationModel: { primary: "vydra/veo3", }, }, },}说明：
vydra/kling会预先拒绝本地文件上传；只有远程图像 URL 引用可用。- Vydra 的
klingHTTP 路由对于它需要image_url还是video_url一直不一致；内置提供商会在两个字段中发送同一个远程图像 URL。 - 内置插件保持保守，不会转发未文档化的样式旋钮，例如宽高比、分辨率、水印或生成的音频。
视频实时测试
提供商专用实时覆盖：
OPENCLAW_LIVE_TEST=1 \OPENCLAW_LIVE_VYDRA_VIDEO=1 \pnpm test:live -- extensions/vydra/vydra.live.test.ts内置的 Vydra 实时文件覆盖：
vydra/veo3文本转视频- 使用远程图像 URL 的
vydra/kling图像转视频
需要时覆盖远程图像夹具：
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"语音合成
将 Vydra 设置为语音提供商：
{ messages: { tts: { provider: "vydra", providers: { vydra: { apiKey: "${VYDRA_API_KEY}", voiceId: "21m00Tcm4TlvDq8ikWAM", }, }, }, },}默认值：
- 模型：
elevenlabs/tts - 语音 ID：
21m00Tcm4TlvDq8ikWAM（“Rachel”）
内置插件公开这一项已知可用的默认语音，并返回 MP3 音频文件。
相关
Was this useful?
