Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw provides pixverse as an official external plugin for hosted PixVerse video generation. The plugin registers the pixverse provider against the videoGenerationProviders contract.
PropertyValue
Provider idpixverse
Plugin package@openclaw/pixverse-provider
Auth env varPIXVERSE_API_KEY
Onboarding flag--auth-choice pixverse-api-key
Direct CLI flag--pixverse-api-key <key>
APIPixVerse Platform API v2 (video_id submission plus result polling)
Default modelpixverse/v6
Default API regionInternational

​
Getting started

1

Install the plugin

openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

Set the API key

openclaw onboard --auth-choice pixverse-api-key
The wizard asks whether to use the International endpoint (https://app-api.pixverse.ai/openapi/v2) or the CN endpoint (https://app-api.pixverseai.cn/openapi/v2) before writing region and baseUrl into the provider config.
3

Set PixVerse as the default video provider

openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
4

Generate a video

Ask the agent to generate a video. PixVerse will be used automatically.

​
Supported modes and models

The provider exposes PixVerse generation models through OpenClaw’s shared video tool.
ModeModelsReference input
Text-to-videov6 (default), c1None
Image-to-videov6 (default), c11 local or remote image
Local image references are uploaded to PixVerse before the image-to-video request. Remote image URLs are passed through the PixVerse image upload endpoint as image_url.
OptionSupported values
Duration1-15 seconds
Resolution360P, 540P, 720P, 1080P
Aspect ratio16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 for text-to-video
Generated audioaudio: true
PixVerse image template generation is not exposed through image_generate yet. That API is template-id driven, while OpenClaw’s shared image-generation contract does not currently have a PixVerse-specific typed option bag.

​
Provider options

The video provider accepts these optional provider-specific keys:
OptionTypeEffect
seednumberDeterministic seed when supported
negativePrompt / negative_promptstringNegative prompt
qualitystringPixVerse quality such as 720p
motionMode / motion_modestringImage-to-video motion mode
cameraMovement / camera_movementstringPixVerse camera movement preset
templateId / template_idnumberActivated PixVerse template id

​
Configuration

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}

​
Advanced configuration

OpenClaw defaults to the international PixVerse API. Set models.providers.pixverse.region manually when your key belongs to a specific PixVerse platform region, or use openclaw onboard --auth-choice pixverse-api-key to choose one in the setup wizard:
Region valuePixVerse API base URL
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}
Set models.providers.pixverse.baseUrl only when routing through a trusted compatible proxy. baseUrl takes precedence over region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
PixVerse returns a video_id from the generation request. OpenClaw polls /openapi/v2/video/result/{video_id} until the task succeeds, fails, or times out.

Video generation

Shared tool parameters, provider selection, and async behavior.

Configuration reference

Agent default settings including video generation model.