媒体提供商实时通道
Deepgram 实时(音频转录)¶
- 测试:
extensions/deepgram/audio.live.test.ts - 启用:
DEEPGRAM_API_KEY=... DEEPGRAM_LIVE_TEST=1 pnpm test:live extensions/deepgram/audio.live.test.ts
BytePlus 编程方案实时¶
- 测试:
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 工作流媒体实时¶
- 测试:
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 工作流提交、轮询、下载或插件注册之后使用尤为有用
图像生成实时¶
- 测试:
test/image-generation.runtime.live.test.ts - 命令:
pnpm test:live test/image-generation.runtime.live.test.ts - 测试脚手架:
pnpm test:live:media image - 范围:
- 枚举所有已注册的图像生成 provider 插件
- 检查前优先使用已导出的 provider 环境变量
- 默认优先使用实时/环境 API 密钥,而非已存储的 auth 配置文件,因此 SQLite auth 存储中的过期测试密钥不会掩盖真实的 shell 凭据
- 跳过没有可用 auth/配置文件/模型的 providers
- 通过共享的图像生成运行时运行每个已配置的 provider:
<provider>:generate- 当 provider 声明支持编辑时,运行
<provider>:edit
- 当前覆盖的内置 providers:
deepinfrafalgoogleminimaxopenaiopenroutervydraxai- 可选范围收窄:
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以强制使用 profile 存储的认证,并忽略仅环境变量的覆盖
对于随附的 CLI 路径,在 provider/运行时实时测试通过后,添加一个 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 参数解析、配置/默认代理解析、内置插件激活、共享的图像生成运行时以及实时 provider 请求。插件依赖项需要在运行时加载之前就已存在。
音乐生成实时¶
- 测试:
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 - 范围:
- 覆盖共享的内置音乐生成 provider 路径
- 当前覆盖
fal、google、minimax和openrouter - 检查前优先使用已导出的 provider 环境变量
- 默认优先使用实时/环境 API 密钥,而非已存储的 auth 配置文件,因此 SQLite auth 存储中的过期测试密钥不会掩盖真实的 shell 凭据
- 跳过没有可用 auth/配置文件/模型的 providers
- 可用时运行两种声明的运行时模式:
generate(仅使用 prompt 输入)- 当 provider 声明
capabilities.edit.enabled时运行edit
comfy有自己的独立实时测试文件,不在此共享扫描范围内- 可选范围收窄:
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以强制使用 profile 存储的认证,并忽略仅环境变量的覆盖
视频生成实时¶
- 测试:
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 - 范围:
- 覆盖共享的内置视频生成 provider 路径,涉及
alibaba、byteplus、deepinfra、fal、google、minimax、openrouter、pixverse、qwen、runway、together、vydra、xai - 默认使用发布安全的冒烟测试路径:每个 provider 发送一次 text-to-video 请求、使用一秒钟的龙虾 prompt,并通过
OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS(默认180000)设定每个 provider 的操作上限 - 默认跳过 FAL,因为 provider 端的队列延迟可能主导发布时间;传入
OPENCLAW_LIVE_VIDEO_GENERATION_PROVIDERS="fal"(或清空跳过列表)即可显式运行 - 检查前优先使用已导出的 provider 环境变量
- 默认优先使用实时/环境 API 密钥,而非已存储的 auth 配置文件,因此 SQLite auth 存储中的过期测试密钥不会掩盖真实的 shell 凭据
- 跳过没有可用 auth/配置文件/模型的 providers
- 默认只运行
generate - 设置
OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1后,在可用时还会运行声明的变换模式:- 当 provider 声明
capabilities.imageToVideo.enabled且所选 provider/模型在共享扫描中接受基于缓冲区的本地图像输入时,运行imageToVideo - 当 provider 声明
capabilities.videoToVideo.enabled且所选 provider/模型在共享扫描中接受基于缓冲区的本地视频输入时,运行videoToVideo
- 当 provider 声明
- 当前共享扫描中已声明但被跳过的
imageToVideoprovider: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 首帧,省略几何信息,请求一秒钟的图像转视频片段,轮询直至完成,并验证下载的缓冲区。
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实时覆盖:- 仅当所选模型解析为
gen4_aleph时运行runway
- 仅当所选模型解析为
- 当前共享扫描中已声明但被跳过的
videoToVideoproviders: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=""用于在默认扫描中包含所有 provider(包括 FAL)OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS=60000用于缩减每个 provider 的操作上限,以进行激进的冒烟运行- 可选认证行为:
- 设置
OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1以强制使用 profile 存储的认证,并忽略仅环境变量的覆盖
媒体实时测试框架¶
- 命令:
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:mediapnpm test:live:media image video --providers google,minimax,xaipnpm test:live:media video --video-providers runway,xai --all-providerspnpm test:live:media music --quiet
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw