Model sağlayıcıları

​

Hızlı kurallar

​

Control UI’da sağlayıcıları yapılandırma

​

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

​

API anahtarı rotasyonu

​

Resmî sağlayıcı Plugin’leri

​

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 ve OPENCLAW_LIVE_OPENAI_KEY (tek geçersiz kılma)
• Yeni kurulum varsayılanı: openai/gpt-5.6; doğrudan API’de çıplak kimlik Sol olarak çözümlenir.
• Örnek modeller: openai/gpt-5.6, openai/gpt-5.6-terra, openai/gpt-5.6-luna, openai/gpt-5.5
• 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 değeridir; OpenClaw aktarım seçimini paylaşılan model çalışma zamanına iletir.
• Model bazında agents.defaults.models["openai/<model>"].params.transport aracılığıyla geçersiz kılın ("sse", "websocket" veya "auto")
• OpenAI öncelikli işleme agents.defaults.models["openai/<model>"].params.serviceTier aracılığıyla etkinleştirilebilir
• /fast ve params.fastMode, api.openai.com üzerindeki doğrudan openai/* Responses isteklerini service_tier=priority olarak 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 adresine giden 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 biçimlendirmesini korur; proxy rotaları korumaz
• openai/gpt-5.3-codex-spark yalnızca ChatGPT/Codex OAuth üzerinden kullanılabilir; doğrudan OpenAI API anahtarı ve Azure API anahtarı rotaları bunu reddeder

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

​

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 ve OPENCLAW_LIVE_ANTHROPIC_KEY (tek geçersiz kılma)
• Örnek model: anthropic/claude-opus-5
• CLI: openclaw onboard --auth-choice apiKey
• Doğrudan genel Anthropic istekleri, api.anthropic.com adresine gönderilen API anahtarı ve OAuth ile kimliği doğrulanmış trafik dâhil olmak üzere paylaşılan /fast anahtarını ve params.fastMode değerini destekler; OpenClaw bunu Anthropic service_tier (auto ile standard_only) biçiminde eşler
• Tercih edilen Claude CLI yapılandırması, model referansını standart biçimde tutar ve CLI arka ucunu ayrı olarak seçer: model kapsamlı agentRuntime.id: "claude-cli" ile anthropic/claude-opus-5. Eski claude-cli/claude-opus-4-7 referansları uyumluluk için çalışmaya devam eder.

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

​

OpenAI ChatGPT/Codex OAuth

• Sağlayıcı: openai
• Kimlik doğrulama: OAuth (ChatGPT)
• Yeni yerel Codex app-server test düzeneği referansı: openai/gpt-5.6-sol
• Yerel Codex app-server test düzeneği belgeleri: Codex test düzeneği
• Eski model referansları: codex/gpt-*, openai-codex/gpt-*
• Plugin sınırı: openai/*, OpenAI Plugin’ini yükler; yerel Codex app-server Plugin’inin seçilip seçilmeyeceğini açık çalışma zamanı politikası veya sağlayıcının sahip olduğu etkin rota belirler.
• CLI: openclaw onboard --auth-choice openai veya openclaw models auth login --provider openai
• OpenClaw’ın yerleşik ChatGPT Responses aktarımı varsayılan olarak auto kullanır (önce WebSocket, yedek olarak SSE).
• agents.defaults.models["openai/<model>"].params.transport, params.serviceTier ve params.fastMode, tanımlanmış yerleşik istek ayarlarıdır. Örtük çalışma zamanı seçimini OpenClaw’da tutarlar; yerel Codex, kendi app-server aktarımının ve hizmet katmanının sahibidir.
• Gizli OpenClaw ilişkilendirme başlıkları (originator, version, User-Agent) genel OpenAI uyumlu proxy’lere değil, yalnızca chatgpt.com/backend-api hedefine giden yerel Codex trafiğine eklenir
• Paylaşılan /fast geçişi, çalışma zamanı denetimi olarak kullanılabilir kalır; tanımlanmış model parametrelerinden farklıdır.
• Yerel Codex kataloğu, hesap erişimine göre tam openai/gpt-5.6-sol, openai/gpt-5.6-terra ve openai/gpt-5.6-luna referanslarını sunabilir. Doğrudan API’nin yalın gpt-5.6 diğer adını istemci tarafında uygulamaz.
• openai/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.models[].contextTokens ile geçersiz kılın
• openai kimlik doğrulamasıyla oturum açın ve abonelik destekli yeni bir kurulum için openai/gpt-5.6-sol kullanın. Bu Codex çalışma alanı GPT-5.6’yı sunmuyorsa açıkça openai/gpt-5.5 seçin.
• Normalde uygun olan bir rotayı yerleşik çalışma zamanında tutmak için agentRuntime.id: "openclaw" sağlayıcı/modelini kullanın. Çalışma zamanı ayarlanmamışsa veya auto ise yalnızca tanımlanmış istek geçersiz kılması bulunmayan, tam ve resmî bir HTTPS Responses/ChatGPT uyumlu rota Codex’i örtük olarak seçebilir.
• Eski Codex GPT referansları canlı bir sağlayıcı rotası değil, eski durumdur. Yeni aracı yapılandırması için standart openai/* referanslarını kullanın ve yerel Codex semantiklerini model kapsamlı agentRuntime.id: "codex" ile koruyarak codex/* ve openai-codex/* referanslarını taşımak için openclaw doctor --fix komutunu çalıştırın. Mevcut açık standart openai/gpt-5.5 seçimleri yükseltilmez.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
    },
  },
}

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

​

Abonelik tarzındaki diğer 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ı dönüşüm: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, yedek olarak GOOGLE_API_KEY ve OPENCLAW_LIVE_GEMINI_KEY (tek geçersiz kılma)
• Örnek modeller: google/gemini-3.1-pro-preview, google/gemini-3.5-flash
• Uyumluluk: google/gemini-3.1-flash-preview kullanan eski OpenClaw yapılandırması google/gemini-3-flash-preview olarak normalleştirilir
• Diğer ad: google/gemini-3.1-pro kabul edilir ve Google’ın canlı Gemini API kimliği olan google/gemini-3.1-pro-preview değerine normalleştirilir
• CLI: openclaw onboard --auth-choice gemini-api-key
• Düşünme: /think adaptive, Google dinamik düşünmeyi kullanır. Gemini 3/3.1, sabit bir thinkingLevel değerini atlar; 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österilir

​

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

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

​

Z.AI (GLM)

• Sağlayıcı: zai
• Kimlik doğrulama: ZAI_API_KEY
• Örnek model: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Model referansları standart zai/* sağlayıcı kimliğini kullanır.
  • zai-api-key, eşleşen Z.AI uç noktasını otomatik olarak 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

​

Paketlenmiş diğer sağlayıcı Plugin’leri

​

Bilinmesi yararlı özel durumlar

​

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

​

Moonshot AI (Kimi)

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

• moonshot/kimi-k2.6
• moonshot/kimi-k3
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.7-code-highspeed
• moonshot/kimi-k2.5

{
  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 Coding

• Sağlayıcı: kimi
• Kimlik doğrulama: KIMI_API_KEY
• Kimi K3: kimi/k3 (256K) veya kimi/k3[1m] (1M plan)
• Kimi Code: kimi/kimi-for-coding
• Kimi Code HighSpeed: kimi/kimi-for-coding-highspeed

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

​

Volcano Engine (Doubao)

• 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" } },
  },
}

​

BytePlus (Uluslararası)

• 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" } },
  },
}

​

Synthetic

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

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

​

MiniMax

• MiniMax OAuth (Küresel): --auth-choice minimax-global-oauth
• MiniMax OAuth (Çin): --auth-choice minimax-cn-oauth
• MiniMax API anahtarı (Küresel): --auth-choice minimax-global-api
• MiniMax API anahtarı (Çin): --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

• Metin/sohbet varsayılanları minimax/MiniMax-M3 üzerinde kalır
• Görsel oluşturma minimax/image-01 veya minimax-portal/image-01 kullanır
• Görsel anlama, her iki MiniMax kimlik doğrulama yolunda da Plugin tarafından yönetilen MiniMax-VL-01 kullanır
• Web araması minimax sağlayıcı kimliğinde kalır

​

LM Studio

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

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

​

Ollama

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

# Ollama'yı kurun, ardından bir model çekin:
ollama pull llama3.3

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

​

vLLM

• 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

export VLLM_API_KEY="vllm-local"

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

​

SGLang

• 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

export SGLANG_API_KEY="sglang-local"

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

​

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

{
  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

​

İlgili

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