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，而 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 的圖片生成影片

在需要時覆寫遠端圖片 fixture：

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 音訊檔案。

Vydra

設定

功能

相關