> ## 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.

# Configuration — provider examples

Worked `models.providers` configurations. For what each field means, see [Custom providers and base URLs](https://docs2.openclaw.ai/gateway/config-tools/custom-providers.md).

## Provider examples

> **Cerebras (GLM 4.7 / GPT OSS)**
>
> The official external `cerebras` provider plugin can configure this via `openclaw onboard --auth-choice cerebras-api-key`. Use explicit provider config only when overriding defaults.
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   env: { vars: { CEREBRAS_API_KEY: "sk-..." } },
>   agents: {
>     defaults: {
>       model: {
>         primary: "cerebras/zai-glm-4.7",
>         fallbacks: ["cerebras/gpt-oss-120b"],
>       },
>       models: {
>         "cerebras/zai-glm-4.7": { alias: "GLM 4.7 (Cerebras)" },
>         "cerebras/gpt-oss-120b": { alias: "GPT OSS 120B (Cerebras)" },
>       },
>     },
>   },
>   models: {
>     mode: "merge",
>     providers: {
>       cerebras: {
>         baseUrl: "https://api.cerebras.ai/v1",
>         apiKey: "${CEREBRAS_API_KEY}",
>         api: "openai-completions",
>         models: [
>           { id: "zai-glm-4.7", name: "GLM 4.7 (Cerebras)" },
>           { id: "gpt-oss-120b", name: "GPT OSS 120B (Cerebras)" },
>         ],
>       },
>     },
>   },
> }
> ```
>
> Use `cerebras/zai-glm-4.7` for Cerebras; `zai/glm-4.7` for Z.AI direct.

> **Kimi Coding**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   env: { vars: { KIMI_API_KEY: "sk-..." } },
>   agents: {
>     defaults: {
>       model: { primary: "kimi/kimi-for-coding" },
>       models: { "kimi/kimi-for-coding": { alias: "Kimi Code" } },
>     },
>   },
> }
> ```
>
> Anthropic-compatible, built-in provider. Shortcut: `openclaw onboard --auth-choice kimi-code-api-key`.

> **Local models (llama.cpp / llama-server)**
>
> The canonical `llama-cpp` provider applies the llama.cpp schema cleaner in managed and existing-server modes. If you instead point a **custom provider ID** at a remote `llama-server` (or another OpenAI-compatible llama.cpp endpoint), set `compat.toolSchemaProfile: "llamacpp"` on each model whose chat template compiles tool arguments into GBNF. The profile removes `pattern` and `maxLength` values at or above 2000, covering the `cron` tool's `trigger.script` limit of 65536. It is a targeted mitigation, not complete compatibility for every JSON Schema constraint or `minLength`.
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "my-llamacpp/qwen35" },
>     },
>   },
>   models: {
>     mode: "merge",
>     providers: {
>       "my-llamacpp": {
>         baseUrl: "http://127.0.0.1:8080/v1",
>         apiKey: "llamacpp-no-key",
>         api: "openai-completions",
>         models: [
>           {
>             id: "qwen35",
>             name: "Qwen3.5 (llama-server)",
>             contextWindow: 8192,
>             maxTokens: 2048,
>             compat: {
>               supportsTools: true,
>               toolSchemaProfile: "llamacpp",
>             },
>           },
>         ],
>       },
>     },
>   },
> }
> ```
>
> For a broader manual alternative, set `compat.unsupportedToolSchemaKeywords: ["pattern", "patternProperties", "format", "propertyNames", "uniqueItems", "contains", "minContains", "maxContains", "minLength", "maxLength"]`. Unlike the profile, this removes every listed keyword unconditionally.

> **Local models (LM Studio)**
>
> See [Local Models](https://docs2.openclaw.ai/gateway/local-models.md). TL;DR: run a large local model via LM Studio Responses API on serious hardware; keep hosted models merged for fallback.

> **MiniMax M3 (direct)**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "minimax/MiniMax-M3" },
>       models: {
>         "minimax/MiniMax-M3": { alias: "Minimax" },
>       },
>     },
>   },
>   models: {
>     mode: "merge",
>     providers: {
>       minimax: {
>         baseUrl: "https://api.minimax.io/anthropic",
>         apiKey: "${MINIMAX_API_KEY}",
>         api: "anthropic-messages",
>         models: [
>           {
>             id: "MiniMax-M3",
>             name: "MiniMax M3",
>             reasoning: true,
>             input: ["text", "image"],
>             cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
>             contextWindow: 1000000,
>             maxTokens: 131072,
>           },
>         ],
>       },
>     },
>   },
> }
> ```
>
> Set `MINIMAX_API_KEY`. Shortcuts: `openclaw onboard --auth-choice minimax-global-api` or `openclaw onboard --auth-choice minimax-cn-api`. The model catalog defaults to M3 and also includes the M2.7 variants. On the Anthropic-compatible streaming path, OpenClaw disables MiniMax M2.x thinking by default unless you explicitly set `thinking` yourself; MiniMax-M3 (and M3.x) stays on the provider's omitted/adaptive thinking path by default. `/fast on` or `params.fastMode: true` rewrites `MiniMax-M2.7` to `MiniMax-M2.7-highspeed`.

> **Moonshot AI (Kimi)**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   env: { vars: { MOONSHOT_API_KEY: "sk-..." } },
>   agents: {
>     defaults: {
>       model: { primary: "moonshot/kimi-k2.6" },
>       models: { "moonshot/kimi-k2.6": { alias: "Kimi K2.6" } },
>     },
>   },
>   models: {
>     mode: "merge",
>     providers: {
>       moonshot: {
>         baseUrl: "https://api.moonshot.ai/v1",
>         apiKey: "${MOONSHOT_API_KEY}",
>         api: "openai-completions",
>         models: [
>           {
>             id: "kimi-k2.6",
>             name: "Kimi K2.6",
>             reasoning: false,
>             input: ["text", "image"],
>             cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },
>             contextWindow: 262144,
>             maxTokens: 262144,
>           },
>         ],
>       },
>     },
>   },
> }
> ```
>
> For the China endpoint: `baseUrl: "https://api.moonshot.cn/v1"` or `openclaw onboard --auth-choice moonshot-api-key-cn`.
>
> Native Moonshot endpoints advertise streaming usage compatibility on the shared `openai-completions` transport, and OpenClaw keys that off endpoint capabilities rather than the built-in provider id alone.

> **OpenCode**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "opencode/claude-opus-4-6" },
>       models: { "opencode/claude-opus-4-6": { alias: "Opus" } },
>     },
>   },
> }
> ```
>
> Set `OPENCODE_API_KEY` (or `OPENCODE_ZEN_API_KEY`). Use `opencode/...` refs for the Zen catalog or `opencode-go/...` refs for the Go catalog. Shortcut: `openclaw onboard --auth-choice opencode-zen` or `openclaw onboard --auth-choice opencode-go`.

> **Synthetic (Anthropic-compatible)**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   env: { vars: { SYNTHETIC_API_KEY: "sk-..." } },
>   agents: {
>     defaults: {
>       model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M3" },
>       models: { "synthetic/hf:MiniMaxAI/MiniMax-M3": { alias: "MiniMax M3" } },
>     },
>   },
>   models: {
>     mode: "merge",
>     providers: {
>       synthetic: {
>         baseUrl: "https://api.synthetic.new/anthropic",
>         apiKey: "${SYNTHETIC_API_KEY}",
>         api: "anthropic-messages",
>         models: [
>           {
>             id: "hf:MiniMaxAI/MiniMax-M3",
>             name: "MiniMax M3",
>             reasoning: true,
>             input: ["text", "image"],
>             cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
>             contextWindow: 262144,
>             maxTokens: 65536,
>           },
>         ],
>       },
>     },
>   },
> }
> ```
>
> Base URL should omit `/v1` (Anthropic client appends it). Shortcut: `openclaw onboard --auth-choice synthetic-api-key`.

> **Z.AI (GLM-4.7)**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "zai/glm-4.7" },
>       models: { "zai/glm-4.7": {} },
>     },
>   },
> }
> ```
>
> Set `ZAI_API_KEY`. Model refs use the canonical `zai/*` provider ID. Shortcut: `openclaw onboard --auth-choice zai-api-key`.
>
> * General endpoint: `https://api.z.ai/api/paas/v4`
> * Coding endpoint: `https://api.z.ai/api/coding/paas/v4`
> * The default `zai-api-key` auth choice probes your key and auto-detects which endpoint it belongs to (falling back to a prompt, defaulting to Global, if detection is inconclusive). Dedicated CN and Coding-Plan auth choices are also available for explicit selection.
> * For the general endpoint, define a custom provider with the base URL override.