openclaw/docs/providers/models.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

2.6 KiB

summary read_when title
Model providers (LLMs) supported by OpenClaw
You want to choose a model provider
You want quick setup examples for LLM auth + model selection
Model provider quickstart

Pick a provider, authenticate, then set the default model as provider/model.

Quick start (two steps)

  1. Authenticate with the provider (usually via openclaw onboard).
  2. Set the default model:
{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Supported providers (starter set)

For the full provider catalog and advanced configuration, see Provider directory and Model providers.

Additional provider variants

  • anthropic-vertex - install @openclaw/anthropic-vertex-provider for implicit Anthropic on Google Vertex support. That support applies when Vertex credentials are available. There is no separate onboarding auth choice.
  • copilot-proxy - local VS Code Copilot Proxy bridge. Use openclaw onboard --auth-choice copilot-proxy.
  • google-gemini-cli - optional explicit runtime for canonical google/* models. It requires a local gemini install and a supported Google AI Studio API-key profile. New Gemini CLI or Antigravity OAuth setup is not offered.