openclaw/docs/plugins/reference/zai.md
Peter Steinberger 6d6ea35f76
feat(video): add Kie AI, Z.AI, and Novita video generation (#160080)
* feat(kie): add Kie AI video generation provider

Add 13 documented Market video models with automatic text/image routing, local image uploads, body-level API errors, and bounded polling/downloads. Register API-key onboarding and discovery, wire live QA and CI filters, and document provider capabilities.

Validation: 34 mocked Kie cases pass; core/extension types, bundled registration, inventory, docs, workflow, formatting, and assertion-safety checks pass. Independent review found no actionable issues. The new test command took 186.18s including cold compilation. Live provider proof remains with the lead; Veo awaits API contract reconciliation.

* fix(config): allow Runway and Kie provider credentials in models.providers

Treat runway and kie as bundled provider overlays so apiKey credentials, including SecretRefs, validate without custom baseUrl or models fields. Keep credential resolution in the existing provider auth owner.

Validation: both SecretRef-only schema cases failed before the fix and pass afterward (28 schema cases). All 12 Runway cases pass, including a generated request using the real SDK resolver with a resolved file SecretRef snapshot. Core/extension type checks and the fresh independent review of both requested commits pass.

* feat(zai): add CogVideoX video generation

Extend the Z.AI plugin with regional async CogVideoX text-to-video and image-to-video generation. Reuse provider auth and HTTP helpers, support local image data URIs, and declare duration, geometry, audio, quality, and frame-rate controls.

Wire registration, live provider selection, release shards, generated inventory, and provider documentation. Mocked provider flows, focused contracts, typechecks, inventory, docs, formatting, workflow checks, lint, and assertion safety passed. Live proof remains with the lead.

* feat(novita): add Wan and Hailuo video generation

Extend the Novita plugin with native Wan 2.6 and Hailuo 2.3 async video routes, automatic family image routing, data URI image inputs, and model-specific capabilities. Default Wan output to silent and validate Hailuo duration/resolution combinations before submission.

Wire registration, live provider selection, release shards, generated inventory, and concise provider documentation. Mocked registered-provider flows, focused contracts, typechecks, inventory, docs, formatting, workflow checks, lint, and assertion safety passed. Live proof remains with the lead.

* fix(ci): repair video provider integration checks

Guard the native-live provider list before splitting and add Kie extension and documentation labeler coverage.

Regenerate the config baseline at exactly 4371 plugin entries. The 21 new paths all belong to the shared Kie plugin entry: root/config/enabled (3), hooks (6), llm (8), and subagent (4). Z.AI and Novita add no config entries; existing core, channel, and plugin entries are unchanged.

Focused labeler and native-live shard tests, config baseline, lint, formatting, and diff checks pass. The targeted TS2532 is removed; 19 inherited type diagnostics remain in untouched files. Workflow-planning has the same 17 unique failures and 432 passes on this branch and merge-base 7c346c1c65 because its fixture omits ci-static-step.sh.
2026-09-28 12:48:22 +00:00

737 B

summary read_when title
Adds Z.AI model provider support to OpenClaw.
You are installing, configuring, or auditing the zai plugin
Z.AI plugin reference

Adds Z.AI model provider support to OpenClaw.

Distribution

  • Package: @openclaw/zai-provider
  • Install route: npm or ClawHub: clawhub:@openclaw/zai-provider

Surface

  • Providers: zai
  • Contracts: mediaUnderstandingProviders, usageProviders, videoGenerationProviders