OpenClaw v2026.2 için geçerlidir | Bu makale, temel yapılandırmayı tamamladığınızı ve model seçimini veya maliyet kontrolünü optimize etmek istediğinizi varsayar.

TL;DR: OpenClaw çoklu modeli destekler: Claude Opus/Sonnet/Haiku, GPT-4o, Gemini, yerel modeller (Ollama). Yapılandırma "agent": {"model": "anthropic/claude-opus-4-6"} ile geçiş yapılır. Failover otomatik yedek modele geçer: "fallback": [{"model": "claude-sonnet-4", "condition": "rate_limit"}]. Karmaşık görevler için Claude Opus, yüksek frekanslı basit görevler için Haiku önerilir.

Desteklenen Model Sağlayıcıları

Model Sağlayıcı Genel Bakış

Model Yetenek Karşılaştırması

Temel Model Yapılandırması

Anthropic Claude

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high"
  },
  "models": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}",
      "baseUrl": "https://api.anthropic.com"
    }
  }
}

Claude model seçim önerileri:

OpenAI GPT

{
  "agent": {
    "model": "openai/gpt-4o"
  },
  "models": {
    "openai": {
      "apiKey": "${OPENAI_API_KEY}",
      "baseUrl": "https://api.openai.com/v1",
      "organization": "org-xxx"
    }
  }
}

GPT model seçim önerileri:

Google Gemini

{
  "agent": {
    "model": "google/gemini-2.0-flash"
  },
  "models": {
    "google": {
      "apiKey": "${GOOGLE_API_KEY}",
      "baseUrl": "https://generativelanguage.googleapis.com/v1beta"
    }
  }
}

Yerel Model (Ollama)

{
  "agent": {
    "model": "ollama/llama3.1:70b"
  },
  "models": {
    "ollama": {
      "baseUrl": "http://localhost:11434"
    }
  }
}

Ollama kurulumu ve başlatma:

# Ollama'yı kur
curl -fsSL https://ollama.com/install.sh | sh

# Model indir
ollama pull llama3.1:70b
ollama pull codellama:34b

# Servisi başlat
ollama serve

Üçüncü Taraf API Yönlendirme

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "models": {
    "anthropic": {
      "apiKey": "${PROVIDER_API_KEY}",
      "baseUrl": "https://api.your-provider.com/v1"
    }
  }
}

Model Format Açıklaması

Model Tanımlayıcı Formatı

{provider}/{model-name}

Özel Model Takma Adları

{
  "models": {
    "aliases": {
      "smart": "anthropic/claude-opus-4-6",
      "fast": "anthropic/claude-sonnet-4",
      "cheap": "anthropic/claude-haiku-3.5",
      "local": "ollama/llama3.1:70b"
    }
  },
  "agent": {
    "model": "smart"
  }
}

Takma ad kullanımı:

# Sohbette geçiş yap
/model fast

# Veya tam adı kullan
/model anthropic/claude-sonnet-4

Failover Stratejisi

Failover Nedir?

Ana model kullanılamaz olduğunda (hız sınırı, servis kesintisi gibi), otomatik olarak yedek modele geçiş.

flowchart TB
    REQ[İstek ulaştı] --> PRIMARY{Ana model müsait mi?}
    PRIMARY -->|Evet| EXEC1[Ana modeli kullan]
    PRIMARY -->|Hayır| CHECK{Failover koşulu}
    CHECK -->|Hız sınırı| SECONDARY1[Yedek model 1]
    CHECK -->|Servis kesintisi| SECONDARY2[Yedek model 2]
    CHECK -->|Zaman aşımı| SECONDARY3[Yedek model 3]
    SECONDARY1 --> EXEC2[İsteği yürüt]
    SECONDARY2 --> EXEC2
    SECONDARY3 --> EXEC2
    EXEC1 --> RES[Sonucu döndür]
    EXEC2 --> RES

Failover Yapılandırması

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit"
      },
      {
        "model": "openai/gpt-4o",
        "condition": "error"
      },
      {
        "model": "ollama/llama3.1:70b",
        "condition": "timeout"
      }
    ]
  }
}

Failover Koşulları

Gelişmiş Failover Yapılandırması

{
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit",
        "maxRetries": 3,
        "retryDelay": 1000
      },
      {
        "model": "openai/gpt-4o",
        "condition": "error",
        "maxRetries": 2
      },
      {
        "model": "ollama/llama3.1:70b",
        "condition": "always"
      }
    ],
    "fallbackPolicy": {
      "retryPrimaryAfter": 60000,
      "logFallbacks": true,
      "notifyUser": true
    }
  }
}

Senaryoya Göre Model Geçişi

Oturum Türüne Göre Geçiş

Farklı oturum türleri farklı modeller kullanır:

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4"
    },
    "byChannel": {
      "telegram": {
        "model": "anthropic/claude-haiku-3.5"
      },
      "discord": {
        "model": "anthropic/claude-sonnet-4"
      }
    },
    "bySessionType": {
      "main": {
        "model": "anthropic/claude-opus-4-6"
      },
      "group": {
        "model": "anthropic/claude-haiku-3.5"
      }
    }
  }
}

Görev Türüne Göre Geçiş

{
  "agents": {
    "taskModels": {
      "code": "anthropic/claude-opus-4-6",
      "reasoning": "anthropic/claude-opus-4-6",
      "chat": "anthropic/claude-sonnet-4",
      "simple": "anthropic/claude-haiku-3.5"
    }
  }
}

Dinamik Model Seçimi

Çalışma zamanında model geçişi:

# CLI ile geçiş
openclaw agent --model anthropic/claude-opus-4-6 --message "Karmaşık görev"

# Sohbette geçiş
/model anthropic/claude-opus-4-6
Şimdi Claude Opus 4.6 kullanılıyor, karmaşık akıl yürütme görevleri için uygun

/model anthropic/claude-haiku-3.5
Haiku 3.5'e geçildi, basit görevler için hızlı yanıt

Maliyet Optimizasyon Stratejisi

Model Maliyet Karşılaştırması

Maliyet Optimizasyon Yapılandırması

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4",
      "costOptimization": {
        "enabled": true,
        "rules": [
          {
            "condition": "context_length > 50000",
            "model": "anthropic/claude-sonnet-4"
          },
          {
            "condition": "simple_query",
            "model": "anthropic/claude-haiku-3.5"
          },
          {
            "condition": "code_generation",
            "model": "anthropic/claude-opus-4-6"
          }
        ]
      }
    }
  }
}

Token Kullanım İzleme

# Mevcut oturum kullanımını görüntüle
/status

# Örnek çıktı:
# Session: main
# Model: anthropic/claude-opus-4-6
# Tokens: 12,345 input / 2,456 output
# Cost: $0.21

# Kullanım gösterimini etkinleştir
/usage full

Kullanım Gösterimini Yapılandır

{
  "usageTracking": {
    "enabled": true,
    "showInResponse": true,
    "trackBySession": true,
    "trackByChannel": true,
    "alertThreshold": 10.00
  }
}

Düşünme Seviyesi Yapılandırması

Thinking Level Açıklaması

Düşünme Seviyesini Yapılandır

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high"
  }
}

Dinamik Geçiş

# Sohbette geçiş
/think high
Şimdi yüksek düşünme modu kullanılıyor, karmaşık akıl yürütme için uygun

/think minimal
Minimum düşünmeye geçildi, hızlı yanıt

Yerel Model Yapılandırma Detayları

Ollama Yapılandırması

{
  "agent": {
    "model": "ollama/llama3.1:70b"
  },
  "models": {
    "ollama": {
      "baseUrl": "http://localhost:11434",
      "options": {
        "temperature": 0.7,
        "num_ctx": 32768,
        "num_predict": 4096
      }
    }
  }
}

Önerilen Yerel Modeller

Donanım Önerileri

Çoklu Sağlayıcı Yük Dengeleme

Round-Robin Stratejisi

{
  "models": {
    "loadBalancing": {
      "strategy": "round_robin",
      "providers": [
        {
          "model": "anthropic/claude-sonnet-4",
          "weight": 1
        },
        {
          "model": "openai/gpt-4o",
          "weight": 1
        }
      ]
    }
  }
}

Ağırlıklı Strateji

{
  "models": {
    "loadBalancing": {
      "strategy": "weighted",
      "providers": [
        {
          "model": "anthropic/claude-sonnet-4",
          "weight": 70
        },
        {
          "model": "openai/gpt-4o",
          "weight": 20
        },
        {
          "model": "ollama/llama3.1:70b",
          "weight": 10
        }
      ]
    }
  }
}

Maliyet Tabanlı Strateji

{
  "models": {
    "loadBalancing": {
      "strategy": "cost_optimized",
      "dailyBudget": 10.00,
      "providers": [
        {
          "model": "anthropic/claude-opus-4-6",
          "maxBudget": 5.00,
          "useFor": ["complex", "reasoning"]
        },
        {
          "model": "anthropic/claude-sonnet-4",
          "maxBudget": 3.00,
          "useFor": ["chat", "code"]
        },
        {
          "model": "anthropic/claude-haiku-3.5",
          "maxBudget": 2.00,
          "useFor": ["simple", "high_frequency"]
        }
      ]
    }
  }
}

Model Yapılandırma En İyi Uygulamaları

1. Senaryoya Göre Katmanlama

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4",
      "thinkingLevel": "medium"
    },
    "byUseCase": {
      "coding": {
        "model": "anthropic/claude-opus-4-6",
        "thinkingLevel": "high"
      },
      "chat": {
        "model": "anthropic/claude-haiku-3.5",
        "thinkingLevel": "minimal"
      },
      "research": {
        "model": "anthropic/claude-opus-4-6",
        "thinkingLevel": "xhigh"
      }
    }
  }
}

2. Makul Bütçe Belirleme

{
  "budget": {
    "daily": 20.00,
    "weekly": 100.00,
    "monthly": 400.00,
    "alertThreshold": 0.8,
    "hardLimit": true
  }
}

3. İzleme ve Analiz

{
  "analytics": {
    "trackUsage": true,
    "trackCosts": true,
    "trackPerformance": true,
    "exportPath": "~/.openclaw/analytics",
    "retentionDays": 30
  }
}

4. Test ve Doğrulama

# Model bağlantısını test et
openclaw doctor --check models

# Belirli modeli test et
openclaw agent --model anthropic/claude-opus-4-6 --message "Test mesajı"

# Model yanıtlarını karşılaştır
openclaw benchmark --models "anthropic/claude-opus-4-6,openai/gpt-4o" --prompt "Karmaşık soru"

Sorun Giderme

Model Bağlantısı Başarısız

# API Key'i kontrol et
openclaw config get models.anthropic.apiKey

# Bağlantıyı test et
curl -X POST https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4", "max_tokens": 10, "messages": [{"role": "user", "content": "hi"}]}'

# Ağı kontrol et
ping api.anthropic.com

Hız Sınırı

# Kullanımı görüntüle
openclaw usage --today

# Örnek çıktı:
# Date: 2026-02-26
# Total tokens: 123,456
# Cost: $1.23
# Requests: 89

# Hız sınırı işlemeyi yapılandır
openclaw config set models.anthropic.rateLimitHandling auto_retry

Yerel Model Sorunları

# Ollama servisini kontrol et
curl http://localhost:11434/api/tags

# Modelin yüklü olup olmadığını kontrol et
ollama list

# Modeli manuel yükle
ollama run llama3.1:70b

# GPU kullanımını kontrol et
nvidia-smi

Özet

Çoklu model yapılandırması, OpenClaw’ın güçlü özelliklerinden biridir:

• Esnek geçiş: Görev ihtiyacına göre uygun modeli seçin
• Failover koruması: Model kullanılamaz durumunu otomatik işleme
• Maliyet optimizasyonu: Bütçeyi makul şekilde dağıtın, israfı önleyin
• Yerel destek: Gizlilik duyarlı senaryolarda yerel model kullanın

Makul model yapılandırması ile performans, maliyet ve gizlilik arasında en iyi dengeyi bulabilirsiniz.

Bu Bölümün Özeti:

• Birden fazla model sağlayıcısının yapılandırma yöntemlerini öğrendiniz
• Failover stratejisi ve yapılandırmasını anladınız
• Senaryoya göre dinamik model geçişini öğrendiniz
• Maliyet optimizasyon stratejisi ve izleme yöntemlerini kavradınız
• Yerel modelin yapılandırma ve kullanımını öğrendiniz

Güncelleme Kayıtları:

• 2026-02-26: İlk sürüm yayınlandı, OpenClaw v2026.2 temel alınmıştır

Seri Navigasyonu:

• ← Önceki makale: Gateway Temel Kavramları
• → Sonraki makale: Skills Beceri Sistemi Detaylı Rehber