跳转至

媒体提供商实时通道

Deepgram live（音频转录）

  • 测试文件：extensions/deepgram/audio.live.test.ts
  • 启用方式：DEEPGRAM_API_KEY=... DEEPGRAM_LIVE_TEST=1 pnpm test:live extensions/deepgram/audio.live.test.ts

BytePlus 编程方案 live

  • 测试文件：extensions/byteplus/live.test.ts
  • 启用方式：BYTEPLUS_API_KEY=... BYTEPLUS_LIVE_TEST=1 pnpm test:live extensions/byteplus/live.test.ts
  • 可选模型覆盖：BYTEPLUS_CODING_MODEL=ark-code-latest

ComfyUI 工作流媒体 live

  • 测试文件：extensions/comfy/comfy.live.test.ts
  • 启用方式：OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
  • 范围：
  • 覆盖 comfy 的图像、视频和 music_generate 路径
  • 除非配置了 plugins.entries.comfy.config.<capability>，否则会跳过每项能力
  • 在修改 comfy 工作流提交、轮询、下载或插件注册逻辑后运行该测试会很有用

图像生成 live

  • 测试文件：test/image-generation.runtime.live.test.ts
  • 命令：pnpm test:live test/image-generation.runtime.live.test.ts
  • 测试工具：pnpm test:live:media image
  • 范围：
  • 枚举所有已注册的图像生成提供商插件
  • 探测前会使用已导出的提供商环境变量
  • 默认优先使用 live/env API 密钥，而不是已存储的身份验证配置，因此 SQLite 身份验证存储中的过期测试密钥不会掩盖真实的 shell 凭据
  • 跳过没有可用身份验证/配置文件/模型的提供商
  • 通过共享的图像生成运行时运行每个已配置的提供商：
    • <provider>:generate
    • 当提供商声明支持编辑时执行 <provider>:edit
  • 当前覆盖的内置提供商：
  • deepinfra
  • fal
  • google
  • minimax
  • openai
  • openrouter
  • vydra
  • xai
  • 可选范围限定：
  • OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS="openai,google,openrouter,xai"
  • OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS="deepinfra"
  • OPENCLAW_LIVE_IMAGE_GENERATION_MODELS="openai/gpt-image-2,google/gemini-3.1-flash-image,openrouter/google/gemini-3.1-flash-image-preview,xai/grok-imagine-image"
  • OPENCLAW_LIVE_IMAGE_GENERATION_CASES="google:flash-generate,google:pro-edit,openrouter:generate,xai:default-generate,xai:default-edit"
  • 可选身份验证行为：
  • OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1 以强制使用配置文件存储的身份验证，并忽略仅环境变量的覆盖

对于随产品发布的 CLI 路径，请在提供商/运行时 live 测试通过后，再添加一个 infer 冒烟测试：

OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_INFER_CLI_TEST=1 pnpm test:live -- test/image-generation.infer-cli.live.test.ts
openclaw infer image providers --json
openclaw infer image generate \
  --model google/gemini-3.1-flash-image \
  --prompt "Minimal flat test image: one blue square on a white background, no text." \
  --output ./openclaw-infer-image-smoke.png \
  --json

这覆盖了 CLI 参数解析、配置/默认智能体解析、内置插件激活、共享图像生成运行时以及 live 提供商请求。插件依赖项需要在运行时加载前就绪。

音乐生成 live

  • 测试文件：extensions/music-generation-providers.live.test.ts
  • 启用方式：OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/music-generation-providers.live.test.ts
  • 测试工具：pnpm test:live:media music
  • 范围：
  • 覆盖共享的内置音乐生成提供商路径
  • 目前涵盖 fal、google、minimax 和 openrouter
  • 探测前会使用已导出的提供商环境变量
  • 默认优先使用 live/env API 密钥，而不是已存储的身份验证配置，因此 SQLite 身份验证存储中的过期测试密钥不会掩盖真实的 shell 凭据
  • 跳过没有可用身份验证/配置文件/模型的提供商
  • 当可用时，会运行两种已声明的运行时模式：
    • generate，仅使用 prompt 输入
    • edit，当提供商声明 capabilities.edit.enabled 时
  • comfy 有自己的独立 live 文件，不属于此共享扫描
  • 可选范围限定：
  • OPENCLAW_LIVE_MUSIC_GENERATION_PROVIDERS="google,minimax"
  • OPENCLAW_LIVE_MUSIC_GENERATION_MODELS="google/lyria-3-clip-preview,minimax/music-2.6"
  • 可选身份验证行为：
  • OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1 以强制使用配置文件存储的身份验证，并忽略仅环境变量的覆盖

视频生成 live

  • 测试文件：extensions/video-generation-providers.live.test.ts
  • 启用方式：OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts
  • 测试工具：pnpm test:live:media video
  • 范围：
  • 覆盖共享的内置视频生成提供商路径，包括 alibaba、byteplus、deepinfra、fal、google、minimax、openrouter、pixverse、qwen、runway、together、vydra、xai
  • 默认采用适合发布的冒烟路径：每个提供商一个文本转视频请求、一个时长 1 秒的龙虾 prompt，并通过 OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS（默认 180000）设置每个提供商的操作用时上限
  • 默认跳过 FAL，因为提供商侧的队列延迟可能会主导发布耗时；显式传入 OPENCLAW_LIVE_VIDEO_GENERATION_PROVIDERS="fal"（或清空跳过列表）即可运行
  • 探测前会使用已导出的提供商环境变量
  • 默认优先使用 live/env API 密钥，而不是已存储的身份验证配置，因此 SQLite 身份验证存储中的过期测试密钥不会掩盖真实的 shell 凭据
  • 跳过没有可用身份验证/配置文件/模型的提供商
  • 默认只运行 generate
  • 设置 OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 后，也会在可用时运行已声明的转换模式：
    • 当提供商声明 capabilities.imageToVideo.enabled，且所选提供商/模型接受共享扫描中的缓冲区支持的本地图像输入时，运行 imageToVideo
    • 当提供商声明 capabilities.videoToVideo.enabled，且所选提供商/模型接受共享扫描中的缓冲区支持的本地视频输入时，运行 videoToVideo
  • 当前在共享扫描中已声明但被跳过的 imageToVideo 提供商：
    • vydra（此通道不支持缓冲区支持的本地图像输入）
  • 针对 Vydra 提供商的专项覆盖：
    • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_VYDRA_VIDEO=1 pnpm test:live -- extensions/vydra/vydra.live.test.ts
    • 该文件运行 veo3 文本转视频，以及一个 kling 图像转视频通道，后者默认使用远程图像 URL 测试夹具（可用 OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL 覆盖）。
  • 针对 xAI 提供商的专项覆盖：
    • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "classic Grok Imagine"
    • classic 用例会生成一张方形本地 PNG 首帧，省略 geometry 参数，请求一个一秒的图像转视频片段，轮询直至完成，并验证下载的缓冲区。
    • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "Grok Imagine Video 1.5"
    • 1.5 用例会生成一张本地 PNG 首帧，请求一个一秒的 1080P 图像转视频片段，轮询直至完成，并验证下载的缓冲区。
  • 当前的 videoToVideo live 覆盖：
    • 仅当所选模型解析为 gen4_aleph 时才运行 runway
  • 当前在共享扫描中已声明但被跳过的 videoToVideo 提供商：
    • alibaba、google、qwen、xai，因为这些路径目前需要远程 http(s) 引用 URL，而不是缓冲区支持的本地输入
  • 可选范围限定：
  • OPENCLAW_LIVE_VIDEO_GENERATION_PROVIDERS="deepinfra,google,runway,xai"
  • OPENCLAW_LIVE_VIDEO_GENERATION_MODELS="google/veo-3.1-fast-generate-preview,xai/grok-imagine-video,runway/gen4_aleph"
  • OPENCLAW_LIVE_VIDEO_GENERATION_SKIP_PROVIDERS="" 用于在默认扫描中包含所有提供商，包括 FAL
  • OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS=60000 用于降低每个提供商的操作用时上限，以进行更激进的冒烟运行
  • 可选身份验证行为：
  • OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1 以强制使用配置文件存储的身份验证，并忽略仅环境变量的覆盖

媒体实时测试框架

  • 命令：pnpm test:live:media
  • 入口点：test/e2e/qa-lab/media/hosted-media-provider-live.ts，该入口点会为每个选中的测试套件运行 pnpm test:live -- <suite-test-file>，因此心跳和静默模式行为与其他 pnpm test:live 运行保持一致。
  • 用途：
  • 通过一个仓库原生入口点运行共享的图像、音乐和视频实时测试套件
  • 自动从 ~/.profile 加载缺失的提供商环境变量
  • 默认情况下，自动将每个套件缩小到当前具有可用认证的提供商
  • 标志：
  • --providers <csv> 全局提供商过滤器；--image-providers / --music-providers / --video-providers 将过滤器限定到某个套件
  • --all-providers 跳过基于认证的自动过滤
  • --allow-empty 在过滤后没有可运行提供商时以 0 退出
  • --quiet / --no-quiet 透传到 test:live
  • 示例：
  • pnpm test:live:media
  • pnpm test:live:media image video --providers google,minimax,xai
  • pnpm test:live:media video --video-providers runway,xai --all-providers
  • pnpm test:live:media music --quiet

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw