China Providers

Many China providers support “OpenAI-compatible” APIs, but auth, base URLs, and model ids vary.

Recommended flow

  1. Get one provider working end-to-end (auth → model selection → first reply).
  2. Only then add failover and multi-provider routing.

Common providers

Start with the provider-specific guides:

If you want a unified multi-provider gateway:

Baseline verification (before failover)

After onboarding, verify the provider is healthy and the model is selectable:

openclaw models list
openclaw models status

Then set a single primary model and test in Control UI:

{
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2" }
    }
  }
}

When providers are OpenAI-compatible

If a provider advertises an OpenAI-compatible endpoint, the two knobs that matter most are:

  • models.providers.<id>.baseUrl
  • models.providers.<id>.apiKey

See Model providers for the canonical config shapes and examples.