Model sağlayıcıları

LLM/model sağlayıcıları için başvuru (WhatsApp/Telegram gibi sohbet kanalları değil). Model seçimi kuralları için bkz. Modeller.

# Hızlı kurallar

# Plugin’e ait sağlayıcı davranışı

Sağlayıcıya özgü mantığın çoğu sağlayıcı Plugin’lerinde (registerProvider(...)) yaşarken OpenClaw genel çıkarım döngüsünü tutar. Plugin’ler katılımı, model kataloglarını, kimlik doğrulama ortam değişkeni eşlemesini, aktarım/yapılandırma normalleştirmesini, araç şeması temizliğini, yük devretme sınıflandırmasını, OAuth yenilemeyi, kullanım raporlamayı, düşünme/akıl yürütme profillerini ve daha fazlasını sahiplenir.

Sağlayıcı SDK hook’larının ve paketlenmiş Plugin örneklerinin tam listesi Sağlayıcı Plugin’leri içinde yer alır. Tamamen özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı ayrı ve daha derin bir uzantı yüzeyidir.

# API anahtarı rotasyonu

# Yerleşik sağlayıcılar (pi-ai kataloğu)

OpenClaw pi-ai kataloğuyla birlikte gelir. Bu sağlayıcılar hiçbir models.providers yapılandırması gerektirmez; yalnızca kimlik doğrulamasını ayarlayın ve bir model seçin.

# OpenAI

• Sağlayıcı: openai
• Kimlik doğrulama: OPENAI_API_KEY
• İsteğe bağlı rotasyon: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, ayrıca OPENCLAW_LIVE_OPENAI_KEY (tek geçersiz kılma)
• Örnek modeller: openai/gpt-5.5, openai/gpt-5.4-mini
• Belirli bir kurulum veya API anahtarı farklı davranıyorsa hesap/model kullanılabilirliğini openclaw models list --provider openai ile doğrulayın.
• CLI: openclaw onboard --auth-choice openai-api-key
• Varsayılan aktarım auto olur (önce WebSocket, SSE geri dönüşü)
• Model bazında agents.defaults.models["openai/<model>"].params.transport üzerinden geçersiz kılın ("sse", "websocket" veya "auto")
• OpenAI Responses WebSocket ısınması varsayılan olarak params.openaiWsWarmup (true/false) üzerinden etkinleştirilir
• OpenAI öncelikli işleme agents.defaults.models["openai/<model>"].params.serviceTier üzerinden etkinleştirilebilir
• /fast ve params.fastMode, doğrudan openai/* Responses isteklerini api.openai.com üzerinde service_tier=priority değerine eşler
• Paylaşılan /fast anahtarı yerine açık bir katman istediğinizde params.serviceTier kullanın
• Gizli OpenClaw atıf başlıkları (originator, version, User-Agent) genel OpenAI uyumlu proxy’lere değil, yalnızca api.openai.com üzerindeki yerel OpenAI trafiğine uygulanır
• Yerel OpenAI rotaları ayrıca Responses store, istem önbelleği ipuçları ve OpenAI akıl yürütme uyumluluğu yük şekillendirmesini korur; proxy rotaları korumaz
• openai/gpt-5.3-codex-spark, canlı OpenAI API istekleri bunu reddettiği ve mevcut Codex kataloğu bunu sunmadığı için OpenClaw içinde bilinçli olarak bastırılır

{
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

# Anthropic

• Sağlayıcı: anthropic
• Kimlik doğrulama: ANTHROPIC_API_KEY
• İsteğe bağlı rotasyon: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, ayrıca OPENCLAW_LIVE_ANTHROPIC_KEY (tek geçersiz kılma)
• Örnek model: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Doğrudan herkese açık Anthropic istekleri, api.anthropic.com adresine gönderilen API anahtarı ve OAuth kimlik doğrulamalı trafik dahil olmak üzere paylaşılan /fast anahtarını ve params.fastMode değerini destekler; OpenClaw bunu Anthropic service_tier değerine eşler (auto ve standard_only)
• Tercih edilen Claude CLI yapılandırması model referansını kanonik tutar ve CLI arka ucunu ayrı seçer: agents.defaults.agentRuntime.id: "claude-cli" ile anthropic/claude-opus-4-7. Eski claude-cli/claude-opus-4-7 referansları uyumluluk için çalışmaya devam eder.

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

# OpenAI Codex OAuth

• Sağlayıcı: openai-codex
• Kimlik doğrulama: OAuth (ChatGPT)
• PI model referansı: openai-codex/gpt-5.5
• Yerel Codex uygulama sunucusu donanımı referansı: agents.defaults.agentRuntime.id: "codex" ile openai/gpt-5.5
• Yerel Codex uygulama sunucusu donanımı belgeleri: Codex donanımı
• Eski model referansları: codex/gpt-*
• Plugin sınırı: openai-codex/* OpenAI Plugin’ini yükler; yerel Codex uygulama sunucusu Plugin’i yalnızca Codex donanımı çalışma zamanı veya eski codex/* referanslarıyla seçilir.
• CLI: openclaw onboard --auth-choice openai-codex veya openclaw models auth login --provider openai-codex
• Varsayılan aktarım auto olur (önce WebSocket, SSE geri dönüşü)
• PI modeli bazında agents.defaults.models["openai-codex/<model>"].params.transport üzerinden geçersiz kılın ("sse", "websocket" veya "auto")
• params.serviceTier, yerel Codex Responses isteklerinde de iletilir (chatgpt.com/backend-api)
• Gizli OpenClaw atıf başlıkları (originator, version, User-Agent) genel OpenAI uyumlu proxy’lere değil, yalnızca chatgpt.com/backend-api üzerindeki yerel Codex trafiğine eklenir
• Doğrudan openai/* ile aynı /fast anahtarını ve params.fastMode yapılandırmasını paylaşır; OpenClaw bunu service_tier=priority değerine eşler
• openai-codex/gpt-5.5, Codex kataloğunun yerel contextWindow = 400000 değerini ve varsayılan çalışma zamanı contextTokens = 272000 değerini kullanır; çalışma zamanı sınırını models.providers.openai-codex.models[].contextTokens ile geçersiz kılın
• İlke notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenir.
• Yaygın abonelik artı yerel Codex çalışma zamanı rotası için openai-codex kimlik doğrulamasıyla oturum açın, ancak openai/gpt-5.5 ve agents.defaults.agentRuntime.id: "codex" yapılandırın.
• openai-codex/gpt-5.5 değerini yalnızca PI üzerinden Codex OAuth/abonelik rotasını istediğinizde kullanın; API anahtarı kurulumunuz ve yerel kataloğunuz herkese açık API rotasını sunduğunda Codex çalışma zamanı geçersiz kılması olmadan openai/gpt-5.5 kullanın.
• Daha eski openai-codex/gpt-5.1*, openai-codex/gpt-5.2* ve openai-codex/gpt-5.3* referansları ChatGPT/Codex OAuth hesapları bunları reddettiği için bastırılır; bunun yerine openai-codex/gpt-5.5 veya yerel Codex çalışma zamanı rotasını kullanın.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
      agentRuntime: { id: "codex" },
    },
  },
}

{
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

# Diğer abonelik tarzı barındırılan seçenekler

# OpenCode

• Kimlik doğrulama: OPENCODE_API_KEY (veya OPENCODE_ZEN_API_KEY)
• Zen çalışma zamanı sağlayıcısı: opencode
• Go çalışma zamanı sağlayıcısı: opencode-go
• Örnek modeller: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen veya openclaw onboard --auth-choice opencode-go

{
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

# Google Gemini (API anahtarı)

• Sağlayıcı: google
• Kimlik doğrulama: GEMINI_API_KEY
• İsteğe bağlı rotasyon: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, GOOGLE_API_KEY yedeği ve OPENCLAW_LIVE_GEMINI_KEY (tekil geçersiz kılma)
• Örnek modeller: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Uyumluluk: google/gemini-3.1-flash-preview kullanan eski OpenClaw yapılandırması google/gemini-3-flash-preview olarak normalleştirilir
• Takma ad: google/gemini-3.1-pro kabul edilir ve Google'ın canlı Gemini API kimliği olan google/gemini-3.1-pro-preview olarak normalleştirilir
• CLI: openclaw onboard --auth-choice gemini-api-key
• Düşünme: /think adaptive, Google dinamik düşünmesini kullanır. Gemini 3/3.1 sabit bir thinkingLevel içermez; Gemini 2.5 thinkingBudget: -1 gönderir.
• Doğrudan Gemini çalıştırmaları, sağlayıcıya özgü bir cachedContents/... tanıtıcısını iletmek için agents.defaults.models["google/<model>"].params.cachedContent (veya eski cached_content) değerini de kabul eder; Gemini önbellek isabetleri OpenClaw cacheRead olarak görünür

# Google Vertex ve Gemini CLI

• Sağlayıcılar: google-vertex, google-gemini-cli
• Kimlik doğrulama: Vertex gcloud ADC kullanır; Gemini CLI kendi OAuth akışını kullanır

Gemini CLI OAuth, paketlenen google Plugin kapsamında gönderilir.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

Gemini CLI JSON yanıtları response üzerinden ayrıştırılır; kullanım stats değerine geri döner ve stats.cached, OpenClaw cacheRead olarak normalleştirilir.

# Z.AI (GLM)

• Sağlayıcı: zai
• Kimlik doğrulama: ZAI_API_KEY
• Örnek model: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Takma adlar: z.ai/* ve z-ai/*, zai/* olarak normalleştirilir
  • zai-api-key eşleşen Z.AI uç noktasını otomatik algılar; zai-coding-global, zai-coding-cn, zai-global ve zai-cn belirli bir yüzeyi zorunlu kılar

# Vercel AI Gateway

• Sağlayıcı: vercel-ai-gateway
• Kimlik doğrulama: AI_GATEWAY_API_KEY
• Örnek modeller: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

# Kilo Gateway

• Sağlayıcı: kilocode
• Kimlik doğrulama: KILOCODE_API_KEY
• Örnek model: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Temel URL: https://api.kilo.ai/api/gateway/
• Statik yedek katalog kilocode/kilo/auto ile birlikte gönderilir; canlı https://api.kilo.ai/api/gateway/models keşfi çalışma zamanı kataloğunu daha da genişletebilir.
• kilocode/kilo/auto arkasındaki tam üst akış yönlendirmesi OpenClaw içinde sabit kodlanmamıştır; Kilo Gateway tarafından sahiplenilir.

Kurulum ayrıntıları için /providers/kilocode sayfasına bakın.

# Diğer paketlenmiş sağlayıcı Plugin'leri

# Bilmeye değer tuhaflıklar

# models.providers üzerinden sağlayıcılar (özel/temel URL)

Özel sağlayıcılar veya OpenAI/Anthropic uyumlu proxy’ler eklemek için models.providers (veya models.json) kullanın.

Aşağıdaki paketle gelen sağlayıcı Plugin’lerinin birçoğu zaten varsayılan bir katalog yayımlar. Açık models.providers.<id> girdilerini yalnızca varsayılan temel URL’yi, başlıkları veya model listesini geçersiz kılmak istediğinizde kullanın.

Gateway model yetenek denetimleri, açık models.providers.<id>.models[] meta verilerini de okur. Özel veya proxy bir model görüntü kabul ediyorsa, WebChat ve node kaynaklı ek yollarının görüntüleri yalnızca metin medya referansları yerine yerel model girdileri olarak geçirmesi için o modelde input: ["text", "image"] ayarlayın.

# Moonshot AI (Kimi)

Moonshot, paketle gelen bir sağlayıcı Plugin’i olarak gönderilir. Varsayılan olarak yerleşik sağlayıcıyı kullanın ve açık bir models.providers.moonshot girdisini yalnızca temel URL’yi veya model meta verilerini geçersiz kılmanız gerektiğinde ekleyin:

• Sağlayıcı: moonshot
• Kimlik doğrulama: MOONSHOT_API_KEY
• Örnek model: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key veya openclaw onboard --auth-choice moonshot-api-key-cn

Kimi K2 model kimlikleri:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{
  agents: {
    defaults: { model: { primary: "moonshot/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" }],
      },
    },
  },
}

# Kimi kodlama

Kimi Coding, Moonshot AI’ın Anthropic uyumlu uç noktasını kullanır:

• Sağlayıcı: kimi
• Kimlik doğrulama: KIMI_API_KEY
• Örnek model: kimi/kimi-code

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-code" } },
  },
}

Eski kimi/k2p5, uyumluluk model kimliği olarak kabul edilmeye devam eder.

# Volcano Engine (Doubao)

Volcano Engine (火山引擎), Çin'de Doubao ve diğer modellere erişim sağlar.

• Sağlayıcı: volcengine (kodlama: volcengine-plan)
• Kimlik doğrulama: VOLCANO_ENGINE_API_KEY
• Örnek model: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{
  agents: {
    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
  },
}

İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel volcengine/* kataloğu da aynı anda kaydedilir.

İlk kurulum/yapılandırma model seçicilerinde, Volcengine kimlik doğrulama seçimi hem volcengine/* hem de volcengine-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmemişse OpenClaw, boş bir sağlayıcı kapsamlı seçici göstermek yerine filtrelenmemiş kataloğa geri döner.

# BytePlus (Uluslararası)

BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modellere erişim sağlar.

• Sağlayıcı: byteplus (kodlama: byteplus-plan)
• Kimlik doğrulama: BYTEPLUS_API_KEY
• Örnek model: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{
  agents: {
    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },
  },
}

İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel byteplus/* kataloğu da aynı anda kaydedilir.

İlk kurulum/yapılandırma model seçicilerinde, BytePlus kimlik doğrulama seçimi hem byteplus/* hem de byteplus-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmemişse OpenClaw, boş bir sağlayıcı kapsamlı seçici göstermek yerine filtrelenmemiş kataloğa geri döner.

# Synthetic

Synthetic, synthetic sağlayıcısının arkasında Anthropic uyumlu modeller sağlar:

• Sağlayıcı: synthetic
• Kimlik doğrulama: SYNTHETIC_API_KEY
• Örnek model: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{
  agents: {
    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],
      },
    },
  },
}

# MiniMax

MiniMax, özel uç noktalar kullandığı için models.providers üzerinden yapılandırılır:

• MiniMax OAuth (Küresel): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax API anahtarı (Küresel): --auth-choice minimax-global-api
• MiniMax API anahtarı (CN): --auth-choice minimax-cn-api
• Kimlik doğrulama: minimax için MINIMAX_API_KEY; minimax-portal için MINIMAX_OAUTH_TOKEN veya MINIMAX_API_KEY

Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçaları için /providers/minimax sayfasına bakın.

Plugin'e ait yetenek ayrımı:

• Metin/sohbet varsayılanları minimax/MiniMax-M2.7 üzerinde kalır
• Görüntü üretimi minimax/image-01 veya minimax-portal/image-01 olur
• Görüntü anlama, her iki MiniMax kimlik doğrulama yolunda da Plugin'e ait MiniMax-VL-01 olur
• Web araması sağlayıcı kimliği minimax üzerinde kalır

# LM Studio

LM Studio, yerel API'yi kullanan paketle gelen bir sağlayıcı Plugin'i olarak gönderilir:

• Sağlayıcı: lmstudio
• Kimlik doğrulama: LM_API_TOKEN
• Varsayılan çıkarım temel URL'si: http://localhost:1234/v1

Ardından bir model ayarlayın (http://localhost:1234/api/v1/models tarafından döndürülen kimliklerden biriyle değiştirin):

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

OpenClaw, keşif + otomatik yükleme için LM Studio'nun yerel /api/v1/models ve /api/v1/models/load uç noktalarını, çıkarım içinse varsayılan olarak /v1/chat/completions uç noktasını kullanır. LM Studio JIT yüklemesinin, TTL'nin ve otomatik çıkarma işleminin model yaşam döngüsünü yönetmesini istiyorsanız models.providers.lmstudio.params.preload: false ayarlayın. Kurulum ve sorun giderme için /providers/lmstudio sayfasına bakın.

# Ollama

Ollama, paketle gelen bir sağlayıcı Plugin'i olarak gönderilir ve Ollama'nın yerel API'sini kullanır:

• Sağlayıcı: ollama
• Kimlik doğrulama: Gerekmez (yerel sunucu)
• Örnek model: ollama/llama3.3
• Kurulum: https://ollama.com/download

# Install Ollama, then pull a model:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

Ollama, OLLAMA_API_KEY ile etkinleştirdiğinizde http://127.0.0.1:11434 adresinde yerel olarak algılanır ve paketle gelen sağlayıcı Plugin'i Ollama'yı doğrudan openclaw onboard ve model seçiciye ekler. İlk kurulum, bulut/yerel mod ve özel yapılandırma için /providers/ollama sayfasına bakın.

# vLLM

vLLM, yerel/kendi barındırılan OpenAI uyumlu sunucular için paketle gelen bir sağlayıcı Plugin'i olarak gönderilir:

• Sağlayıcı: vllm
• Kimlik doğrulama: İsteğe bağlı (sunucunuza bağlıdır)
• Varsayılan temel URL: http://127.0.0.1:8000/v1

Yerel olarak otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulamayı zorunlu kılmıyorsa herhangi bir değer çalışır):

export VLLM_API_KEY="vllm-local"

Ardından bir model ayarlayın (/v1/models tarafından döndürülen kimliklerden biriyle değiştirin):

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

Ayrıntılar için /providers/vllm sayfasına bakın.

# SGLang

SGLang, hızlı kendi barındırılan OpenAI uyumlu sunucular için paketle gelen bir sağlayıcı Plugin'i olarak gönderilir:

• Sağlayıcı: sglang
• Kimlik doğrulama: İsteğe bağlı (sunucunuza bağlıdır)
• Varsayılan temel URL: http://127.0.0.1:30000/v1

Yerel olarak otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulamayı zorunlu kılmıyorsa herhangi bir değer çalışır):

export SGLANG_API_KEY="sglang-local"

Ardından bir model ayarlayın (/v1/models tarafından döndürülen kimliklerden biriyle değiştirin):

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

Ayrıntılar için /providers/sglang sayfasına bakın.

# Yerel proxy'ler (LM Studio, vLLM, LiteLLM vb.)

Örnek (OpenAI uyumlu):

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/my-local-model" },
      models: { "lmstudio/my-local-model": { alias: "Local" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

# CLI örnekleri

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

Ayrıca bkz.: tam yapılandırma örnekleri için Yapılandırma.

# İlgili

• Yapılandırma referansı - model yapılandırma anahtarları
• Model failover - geri dönüş zincirleri ve yeniden deneme davranışı
• Modeller - model yapılandırması ve takma adlar
• Sağlayıcılar - sağlayıcı bazında kurulum kılavuzları