openclaw-models

OpenClaw Models & Providers

Guide the user through model selection, provider setup, failover, and per-agent model configuration.

Model Selection

Configuration

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: ["openai/gpt-5.2"],
      },
    },
  },
}

Model refs use provider/model format (e.g., anthropic/claude-opus-4-6).

/model Command

Users can switch models in chat:

• /model — show current model
• /model anthropic/claude-opus-4-6 — switch to a specific model
• /model Sonnet — switch using alias (if configured in catalog)

Per-Agent Override

{
  agents: {
    list: [
      {
        id: "opus",
        model: { primary: "anthropic/claude-opus-4-6" },
      },
      {
        id: "fast",
        model: { primary: "anthropic/claude-haiku-4-5-20251001" },
      },
    ],
  },
}

Provider Configuration

Built-in Providers

OpenClaw supports many providers out of the box:

• Anthropic (claude-opus, claude-sonnet, claude-haiku)
• OpenAI (gpt-5.2, gpt-4.1, etc.)
• OpenRouter (unified gateway for multiple providers)
• Amazon Bedrock, Google, Mistral, Ollama (local), vLLM (local)
• And many more — see openclaw onboard for interactive setup

Custom Providers

Add any OpenAI-compatible endpoint:

{
  models: {
    providers: {
      "my-custom": {
        apiKey: "${MY_API_KEY}",
        baseUrl: "https://api.example.com/v1",
      },
    },
  },
}

Then use as: my-custom/model-name.

API Key Configuration

Three methods:

1. Environment variable: Set ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.
2. Config inline: models.providers.<name>.apiKey: "sk-..."
3. SecretRef (recommended):

   {
     models: {
       providers: {
         openai: {
           apiKey: { source: "env", provider: "default", id: "OPENAI_API_KEY" },
         },
       },
     },
   }
   

Interactive Setup