快速开始

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>
契约 imageGenerationProvidersvideoGenerationProvidersspeechProviders
基础 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 引用。
    • Vydra 的 kling HTTP 路由对于要求使用 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
    • 语音 ID:21m00Tcm4TlvDq8ikWAM(“Rachel”)

    内置插件提供这一种已知可用的默认语音,并返回 MP3 音频文件。

    相关内容

    Was this useful?
    On this page

    On this page