メインコンテンツへスキップ

Vydra

バンドル済みのVydra pluginは、次を追加します。
  • vydra/grok-imagineによる画像生成
  • vydra/veo3およびvydra/klingによる動画生成
  • VydraのElevenLabsベースTTSルートによる音声合成
OpenClawは、この3つの機能すべてで同じVYDRA_API_KEYを使用します。

重要なベースURL

https://www.vydra.ai/api/v1を使用してください。 Vydraのapexホスト(https://vydra.ai/api/v1)は現在wwwへリダイレクトします。一部のHTTPクライアントは、そのクロスホストリダイレクト時にAuthorizationを落とすため、有効なAPIキーが誤解を招く認証失敗に見えることがあります。バンドル済みpluginは、これを避けるためにwwwのベースURLを直接使用します。

セットアップ

対話型オンボーディング:
openclaw onboard --auth-choice vydra-api-key
または、env varを直接設定します。
export VYDRA_API_KEY="vydra_live_..."

画像生成

デフォルトの画像モデル:
  • vydra/grok-imagine
これをデフォルトの画像プロバイダーとして設定します。
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
現在のバンドル済みサポートはtext-to-imageのみです。Vydraのホスト型編集ルートはリモート画像URLを想定しており、OpenClawはまだバンドル済みpluginにVydra専用のアップロードブリッジを追加していません。 共有ツール動作については、Image Generationを参照してください。

動画生成

登録済み動画モデル:
  • text-to-video用のvydra/veo3
  • image-to-video用のvydra/kling
Vydraをデフォルトの動画プロバイダーとして設定します。
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
注意:
  • vydra/veo3はバンドル済みではtext-to-video専用です。
  • vydra/klingは現在、リモート画像URL参照を必要とします。ローカルファイルアップロードは事前に拒否されます。
  • Vydraの現在のkling HTTPルートは、image_urlvideo_urlのどちらを要求するかが一貫していません。バンドル済みproviderは、同じリモート画像URLを両方のフィールドへマッピングします。
  • バンドル済みpluginは保守的なままで、aspect ratio、resolution、watermark、生成音声のような文書化されていないスタイル指定は転送しません。
プロバイダー固有のライブカバレッジ:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
バンドル済みのVydraライブファイルは現在、次をカバーしています。
  • vydra/veo3 text-to-video
  • リモート画像URLを使用したvydra/kling image-to-video
必要に応じて、リモート画像フィクスチャをオーバーライドします。
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
共有ツール動作については、Video Generationを参照してください。

音声合成

Vydraを音声プロバイダーとして設定します。
{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          voiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
デフォルト:
  • モデル: elevenlabs/tts
  • voice id: 21m00Tcm4TlvDq8ikWAM
バンドル済みpluginは現在、動作確認済みのデフォルト音声を1つ公開しており、MP3音声ファイルを返します。

関連