OpenClawDocs
On this page

On this page

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

NovitaAI

NovitaAI is a hosted AI infrastructure provider with an OpenAI-compatible API. OpenClaw provides NovitaAI through the official external @openclaw/novita-provider plugin. Model refs use the novita/deepseek/deepseek-v4-pro form.

Setup

Install the plugin:

bash
openclaw plugins install @openclaw/novita-provider

Installation applies to a running Gateway automatically; otherwise it takes effect on the next startup. See Apply changes and inspect.

Create an API key at novita.ai/settings/key-management, then run:

bash
openclaw onboard --auth-choice novita-api-key

Or set:

bash
export NOVITA_API_KEY="<your-novita-api-key>" # pragma: allowlist secret

Defaults

Setting Value
Plugin @openclaw/novita-provider
Provider id novita
Aliases novita-ai, novitaai
Base URL https://api.novita.ai/openai/v1
Env var NOVITA_API_KEY
Default model novita/deepseek/deepseek-v4-pro

Model catalog

  • novita/moonshotai/kimi-k3
  • novita/moonshotai/kimi-k2.7-code
  • novita/minimax/minimax-m3
  • novita/zai-org/glm-5.2
  • novita/deepseek/deepseek-v4-pro
  • novita/deepseek/deepseek-v4-flash
  • novita/qwen/qwen3.7-max

novita/minimax/minimax-m2.7 remains selectable as a deprecated compatibility entry but is hidden from model pickers.

This is a starting point, not a live catalog. Your account, region, or Novita's current offering may add, remove, or restrict routes. Check before setting a long-lived default:

bash
openclaw models list --provider novita

Video generation

The same plugin and NOVITA_API_KEY support the video generation tool through Novita's native asynchronous API at https://api.novita.ai.

Model Modes Duration Resolution
wan2.6-t2v (default) Text or one image to video 5/10/15s 720P, 1080P
wan2.6-i2v One image to video 5/10/15s 720P, 1080P
minimax-hailuo-2.3-t2v Text or one image to video 6/10s 768P, 1080P
minimax-hailuo-2.3-i2v One image to video 6/10s 768P, 1080P
minimax-hailuo-2.3-fast-i2v One image to video 6/10s 768P, 1080P

Supplying one image with a -t2v model selects the same family's -i2v route. Both families accept remote image URLs and local image files, sent as data URIs. Hailuo supports 1080P only for 6-second videos; use 768P for 10 seconds. Video reference inputs are unsupported.

Wan defaults to silent output; set audio: true to generate audio. It also accepts one remote HTTP(S) audio reference. Text-to-video supports 16:9, 9:16, 1:1, 4:3, and 3:4; image-to-video inherits the source aspect ratio. Wan options are negative_prompt, prompt_extend, shot_type (single or multi), and seed. Hailuo options are enable_prompt_expansion and fast_pretreatment (the latter is unavailable on the Fast model).

json5
{  agents: {    defaults: {      mediaModels: {        video: {          primary: "novita/wan2.6-t2v",        },      },    },  },}

When to choose Novita

  • Hosted open-weight model access with an OpenAI-compatible API.
  • DeepSeek, Kimi, MiniMax, GLM, or Qwen-family routes through a single provider account.
  • Another hosted fallback path beside DeepInfra, GMI, OpenRouter, or direct vendor APIs.
  • Provider-side model hosting instead of maintaining LM Studio, Ollama, SGLang, or vLLM infrastructure.

Choose a direct vendor provider when you need vendor-native request parameters or support contracts. Choose a local provider when the model must run on your own hardware or network boundary.

Troubleshooting

  • 401/403: verify the key in Novita's key management page and re-run openclaw onboard --auth-choice novita-api-key if the stored profile is stale.
  • Unknown model errors: use the exact novita/<route-id> returned by openclaw models list --provider novita.
  • Slow or failed routes: try another Novita model route, or set Novita as a fallback provider for workloads that can tolerate provider-specific variance.
Was this useful?