Model Failover

Automatic failover between AI models.

Overview

Model failover automatically switches to backup models when the primary model fails.

Configuration

{
  models: {
    default: "claude-3-5-sonnet",
    failover: [
      "claude-3-sonnet",
      "gpt-4-turbo",
      "gpt-3.5-turbo"
    ]
  }
}

Failover Triggers

The system switches to failover when:

• API rate limit exceeded
• API key invalid
• Model unavailable
• Timeout exceeded
• Server error

Failover Behavior

Primary Model
     │
     ▼ (error)
Failover 1
     │
     ▼ (error)
Failover 2
     │
     ▼ (error)
Error Response

Configuration Options

{
  failover: {
    enabled: true,
    maxRetries: 3,
    retryDelay: 1000,      // ms between retries
    resetAfter: 300000     // ms before trying primary again
  }
}

Provider Failover

Also supports failing over between providers:

{
  failover: {
    providers: ["anthropic", "openai", "openrouter"]
  }
}

Monitoring

Check failover status:

openclaw models status --failover

See Also

• Models
• Providers