在 OpenClaw 中配置 Vydra Provider 可实现 grok-imagine 图片生成、veo3/kling 视频生成和 ElevenLabs 语音合成。关键操作：设置环境变量 VYDRA_API_KEY，并在 Agent 或 TTS 配置中引用对应模型 ID。注意 Base URL 必须使用 https://www.vydra.ai/api/v1，否则因重定向丢失 Authorization 头导致鉴权失败；kling 图生视频只接受远程 URL，不支持本地文件上传。

OpenClaw 接入 Vydra：图片视频语音配置指南

OpenClaw 内置 Vydra 插件（默认启用），提供三种媒体生成能力，共用同一个 API Key。

属性	值
Provider ID	vydra
插件类型	内置，enabledByDefault: true
认证环境变量	VYDRA_API_KEY
交互式引导参数	openclaw onboard --auth-choice vydra-api-key
直接 CLI 参数	--vydra-api-key <key>
合约字段	imageGenerationProviders、videoGenerationProviders、speechProviders
基础 URL	https://www.vydra.ai/api/v1（必须带 www）

⚠️ Base URL 陷阱：必须使用 https://www.vydra.ai/api/v1。https://vydra.ai/api/v1（无 www）会 301 重定向到 www，部分 HTTP 客户端在跨主机重定向时会丢弃 Authorization 头，导致有效 API Key 返回错误鉴权失败。内置插件已直接使用 www 地址，但手动配置时务必注意。

基本配置

第 1 步：设置 API Key

openclaw onboard --auth-choice vydra-api-key

或者直接设置环境变量：

export VYDRA_API_KEY="vydra_live_..."

第 2 步：选择需要的能力

根据需求配置下文中的图片、视频或语音能力。

能力配置

图片生成

默认图片模型：vydra/grok-imagine

设为默认 Provider：

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}

当前仅支持文生图。Vydra 托管的编辑接口需要远程图片 URL，内置插件暂未提供上传桥接。

视频生成

注册的视频模型：

• vydra/veo3（文生视频）
• vydra/kling（图生视频）

设为默认 Provider：

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}

注意事项：

• vydra/veo3：仅文生视频，无参考图片输入。
• vydra/kling：需要远程图片 URL，直接拒绝本地文件上传。
• Vydra 的 kling 接口对 image_url 或 video_url 字段要求不一致，内置插件将同一远程图片 URL 同时填入两个字段。
• 不转发未公开的样式参数（宽高比、分辨率、水印、生成音频等）。

视频端到端测试

运行 Vydra 视频的集成测试：

OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts

覆盖测试项：

• vydra/veo3 文生视频
• vydra/kling 图生视频（使用远程图片 URL）

可覆盖远程图片 fixture：

export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"

语音合成

设为 TTS Provider：

{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          voiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}

默认模型：elevenlabs/tts，默认音色 ID：21m00Tcm4TlvDq8ikWAM，返回 MP3 音频文件。

常见问题

Vydra API Key 在哪里设置？

通过环境变量 VYDRA_API_KEY 设置，或在运行 openclaud onboard 时使用 --auth-choice vydra-api-key 交互式输入。

为什么 Base URL 必须用 www 而不能用 apex 域名？

Vydra 的 apex 域名（https://vydra.ai/api/v1）会 301 重定向到 www，部分 HTTP 客户端（如某些 curl 版本或 Node.js fetch）在跨主机重定向时会丢弃 Authorization 头，导致有效 API Key 报鉴权错误。

kling 视频生成为什么不能上传本地图片？

Vydra 的 kling 接口目前只接受远程图片 URL 作为输入，上传本地文件会直接被插件拒绝。如果需要测试，可以先上传图片到公开 URL，再通过 OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL 环境变量指定。