Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

内置 Vydra 插件会添加：
  • 通过 vydra/grok-imagine 生成图像
  • 通过 vydra/veo3 和 vydra/kling 生成视频
  • 通过 Vydra 的 ElevenLabs 支持的 TTS 路由合成语音
OpenClaw 对这三项能力使用同一个 VYDRA_API_KEY。
属性值
提供商 IDvydra
插件内置，enabledByDefault: true
认证环境变量VYDRA_API_KEY
新手引导标志--auth-choice vydra-api-key
直接 CLI 标志--vydra-api-key <key>
契约imageGenerationProviders, videoGenerationProviders, speechProviders
基础 URLhttps://www.vydra.ai/api/v1（使用 www 主机）
使用 https://www.vydra.ai/api/v1 作为基础 URL。Vydra 的根域主机（https://vydra.ai/api/v1）目前会重定向到 www。一些 HTTP 客户端会在这种跨主机重定向中丢弃 Authorization，这会把有效的 API 密钥变成误导性的认证失败。内置插件会直接使用 www 基础 URL 来避免这种情况。

​
设置

1

运行交互式新手引导

openclaw onboard --auth-choice vydra-api-key
或者直接设置环境变量：
export VYDRA_API_KEY="vydra_live_..."
2

选择默认能力

从以下能力中选择一个或多个（图像、视频或语音），并应用匹配的配置。

​
能力

默认图像模型：
  • vydra/grok-imagine
将它设为默认图像提供商：
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
当前内置支持仅限文本转图像。Vydra 托管的编辑路由需要远程图像 URL，而 OpenClaw 还没有在内置插件中添加 Vydra 专用的上传桥接。
请参阅图像生成，了解通用工具参数、提供商选择和故障转移行为。
已注册的视频模型：
  • vydra/veo3 用于文本转视频
  • vydra/kling 用于图像转视频
将 Vydra 设为默认视频提供商：
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
备注：
  • vydra/veo3 内置为仅支持文本转视频。
  • vydra/kling 目前需要远程图像 URL 引用。本地文件上传会在一开始就被拒绝。
  • Vydra 当前的 kling HTTP 路由在要求 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 文本转视频
  • vydra/kling 使用远程图像 URL 进行图像转视频
需要时覆盖远程图像测试夹具：
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
内置插件目前公开一个已知可用的默认声音，并返回 MP3 音频文件。

​
相关内容

提供商目录

浏览所有可用的提供商。

图像生成

通用图像工具参数和提供商选择。

视频生成

通用视频工具参数和提供商选择。

配置参考

Agent 默认值和模型配置。