--- read_when: - Sağlayıcı bazında bir model kurulumu referansına ihtiyacınız var - Model sağlayıcıları için örnek yapılandırmalar veya CLI katılım komutları istiyorsunuz sidebarTitle: Model providers summary: Örnek yapılandırmalar + CLI akışlarıyla model sağlayıcısına genel bakış title: Model sağlayıcıları x-i18n: generated_at: "2026-05-11T20:27:42Z" model: gpt-5.5 provider: openai source_hash: 8a3cde106981c2601c0b127116c8b5968a9f95571245fc795e9a181243fc3b7e source_path: concepts/model-providers.md workflow: 16 --- **LLM/model sağlayıcıları** için referans (WhatsApp/Telegram gibi sohbet kanalları değil). Model seçimi kuralları için bkz. [Modeller](/tr/concepts/models). ## Hızlı kurallar - Model referansları `provider/model` kullanır (örnek: `opencode/claude-opus-4-6`). - `agents.defaults.models` ayarlandığında izin listesi olarak davranır. - CLI yardımcıları: `openclaw onboard`, `openclaw models list`, `openclaw models set `. - `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` sağlayıcı düzeyi varsayılanları ayarlar; `models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` bunları model başına geçersiz kılar. - Yedekleme kuralları, cooldown yoklamaları ve oturum geçersiz kılma kalıcılığı: [Model failover](/tr/concepts/model-failover). Bir sağlayıcı eklediğinizde veya yeniden yetkilendirdiğinizde `openclaw configure` mevcut bir `agents.defaults.model.primary` değerini korur. `openclaw models auth login`, `--set-default` iletmediğiniz sürece aynısını yapar. Sağlayıcı Plugin’leri auth yapılandırma yamasında yine de önerilen bir varsayılan model döndürebilir, ancak OpenClaw bunu birincil model zaten varsa "geçerli birincil modeli değiştir" olarak değil, "bu modeli kullanılabilir yap" olarak ele alır. Varsayılan modeli bilinçli olarak değiştirmek için `openclaw models set ` veya `openclaw models auth login --provider --set-default` kullanın. OpenAI ailesi rotaları öneke özeldir: - `openai/` agent dönüşleri için varsayılan olarak yerel Codex uygulama sunucusu harness’ını kullanır. Bu, olağan ChatGPT/Codex abonelik kurulumudur. - `openai-codex/`, doctor’ın `openai/` olarak yeniden yazdığı eski yapılandırmadır. - `openai/` ve sağlayıcı/model `agentRuntime.id: "pi"` açık API anahtarı veya uyumluluk rotaları için PI kullanır. Bkz. [OpenAI](/tr/providers/openai) ve [Codex harness](/tr/plugins/codex-harness). Sağlayıcı/çalışma zamanı ayrımı kafa karıştırıyorsa önce [Agent çalışma zamanları](/tr/concepts/agent-runtimes) bölümünü okuyun. Plugin otomatik etkinleştirme aynı sınırı izler: `openai/*` agent referansları varsayılan rota için Codex Plugin’ini etkinleştirir ve açık sağlayıcı/model `agentRuntime.id: "codex"` veya eski `codex/` referansları da bunu gerektirir. GPT-5.5, varsayılan olarak `openai/gpt-5.5` üzerinde yerel Codex uygulama sunucusu harness’ı üzerinden ve yalnızca sağlayıcı/model çalışma zamanı ilkesi açıkça `pi` seçtiğinde PI üzerinden kullanılabilir. CLI çalışma zamanları aynı ayrımı kullanır: `anthropic/claude-*`, `google/gemini-*` veya `openai/gpt-*` gibi kanonik model referansları seçin, ardından yerel CLI backend istediğinizde sağlayıcı/model çalışma zamanı ilkesini `claude-cli`, `google-gemini-cli` veya `codex-cli` olarak ayarlayın. Eski `claude-cli/*`, `google-gemini-cli/*` ve `codex-cli/*` referansları, çalışma zamanı ayrı kaydedilerek kanonik sağlayıcı referanslarına geri taşınır. ## 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ü korur. Plugin’ler onboarding, model katalogları, auth env-var eşlemesi, taşıma/yapılandırma normalleştirmesi, araç şeması temizliği, failover sınıflandırması, OAuth yenileme, kullanım raporlama, düşünme/akıl yürütme profilleri ve daha fazlasından sorumludur. Provider-SDK hook’larının ve paketle gelen Plugin örneklerinin tam listesi [Provider plugins](/tr/plugins/sdk-provider-plugins) bölümündedir. Tamamen özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı ayrı ve daha derin bir uzantı yüzeyidir. Sağlayıcıya ait runner davranışı replay ilkesi, araç şeması normalleştirmesi, akış sarmalama ve taşıma/istek yardımcıları gibi açık sağlayıcı hook’larında yaşar. Eski `ProviderPlugin.capabilities` statik çantası yalnızca uyumluluk içindir ve paylaşılan runner mantığı tarafından artık okunmaz. ## API anahtarı rotasyonu Birden fazla anahtarı şunlarla yapılandırın: - `OPENCLAW_LIVE__KEY` (tek canlı geçersiz kılma, en yüksek öncelik) - `_API_KEYS` (virgül veya noktalı virgül listesi) - `_API_KEY` (birincil anahtar) - `_API_KEY_*` (numaralı liste, örn. `_API_KEY_1`) Google sağlayıcıları için `GOOGLE_API_KEY` de yedek olarak dahil edilir. Anahtar seçimi sırası önceliği korur ve değerleri tekilleştirir. - İstekler yalnızca rate-limit yanıtlarında sonraki anahtarla yeniden denenir (örneğin `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, `workers_ai ... quota limit exceeded` veya periyodik kullanım sınırı mesajları). - Rate-limit olmayan hatalar hemen başarısız olur; anahtar rotasyonu denenmez. - Tüm aday anahtarlar başarısız olduğunda, son hata son denemeden döndürülür. ## 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 auth ayarlayın ve bir model seçin. ### OpenAI - Sağlayıcı: `openai` - Auth: `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 taşıma `auto` değeridir; OpenClaw taşıma seçimini pi-ai’ye iletir. - Model başına `agents.defaults.models["openai/"].params.transport` üzerinden geçersiz kılın (`"sse"`, `"websocket"` veya `"auto"`) - OpenAI öncelikli işleme `agents.defaults.models["openai/"].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` açma kapaması 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’lerde değil, yalnızca `api.openai.com` adresine giden yerel OpenAI trafiğinde uygulanır - Yerel OpenAI rotaları ayrıca Responses `store`, prompt-cache ipuçları ve OpenAI reasoning-compat yük şekillendirmesini korur; proxy rotaları bunu yapmaz - `openai/gpt-5.3-codex-spark`, canlı OpenAI API istekleri bunu reddettiği ve geçerli Codex kataloğu bunu sunmadığı için OpenClaw içinde bilinçli olarak bastırılır ```json5 { agents: { defaults: { model: { primary: "openai/gpt-5.5" } } }, } ``` ### Anthropic - Sağlayıcı: `anthropic` - Auth: `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 genel Anthropic istekleri, `api.anthropic.com` adresine gönderilen API anahtarı ve OAuth ile kimliği doğrulanmış trafik dahil olmak üzere paylaşılan `/fast` açma kapamasını ve `params.fastMode` değerini destekler; OpenClaw bunu Anthropic `service_tier` değerine (`auto` ve `standard_only`) eşler - Tercih edilen Claude CLI yapılandırması model referansını kanonik tutar ve CLI backend’ini ayrı seçer: model kapsamlı `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. Anthropic çalışanları bize OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi; bu nedenle OpenClaw, Anthropic yeni bir ilke yayımlamadığı sürece Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder. Anthropic setup-token desteklenen bir OpenClaw token yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mevcut olduğunda Claude CLI yeniden kullanımını ve `claude -p` kullanımını tercih eder. ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, } ``` ### OpenAI Codex OAuth - Sağlayıcı: `openai-codex` - Auth: OAuth (ChatGPT) - Eski PI model referansı: `openai-codex/gpt-5.5` - Yerel Codex uygulama sunucusu harness referansı: `openai/gpt-5.5` - Yerel Codex uygulama sunucusu harness belgeleri: [Codex harness](/tr/plugins/codex-harness) - 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 harness çalışma zamanı veya eski `codex/*` referansları tarafından seçilir. - CLI: `openclaw onboard --auth-choice openai-codex` veya `openclaw models auth login --provider openai-codex` - Varsayılan taşıma `auto` değeridir (önce WebSocket, SSE yedeği) - PI modeli başına `agents.defaults.models["openai-codex/"].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’lerde değil, yalnızca `chatgpt.com/backend-api` adresine giden yerel Codex trafiğine eklenir - Doğrudan `openai/*` ile aynı `/fast` açma kapaması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ğu 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` auth ile oturum açın ancak `openai/gpt-5.5` yapılandırın; OpenAI agent dönüşleri varsayılan olarak Codex’i seçer. - PI üzerinden uyumluluk rotası istediğinizde yalnızca sağlayıcı/model `agentRuntime.id: "pi"` kullanın; aksi halde `openai/gpt-5.5` değerini varsayılan Codex harness üzerinde tutun. - 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. ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 { models: { providers: { "openai-codex": { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### Diğer abonelik tarzı barındırılan seçenekler Z.AI Coding Plan veya genel API uç noktaları. MiniMax Coding Plan OAuth veya API anahtarı erişimi. Qwen Cloud sağlayıcı yüzeyi, ayrıca Alibaba DashScope ve Coding Plan uç noktası eşlemesi. ### OpenCode - Auth: `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` ```json5 { 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ğine, `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ı ayrıca sağlayıcıya özgü bir `cachedContents/...` tanıtıcısını iletmek için `agents.defaults.models["google/"].params.cachedContent` (veya eski `cached_content`) değerini 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 OpenClaw içindeki Gemini CLI OAuth resmi olmayan bir entegrasyondur. Bazı kullanıcılar, üçüncü taraf istemcileri kullandıktan sonra Google hesabı kısıtlamaları bildirmiştir. Devam etmeyi seçerseniz Google şartlarını inceleyin ve kritik olmayan bir hesap kullanın. Gemini CLI OAuth, paketle gelen `google` Plugin'inin parçası olarak gönderilir. ```bash brew install gemini-cli ``` ```bash npm install -g @google/gemini-cli ``` ```bash openclaw plugins enable google ``` ```bash openclaw models auth login --provider google-gemini-cli --set-default ``` Varsayılan model: `google-gemini-cli/gemini-3-flash-preview`. `openclaw.json` içine bir istemci kimliği veya gizli anahtar **yapıştırmazsınız**. CLI oturum açma akışı, tokenları Gateway ana makinesindeki kimlik doğrulama profillerinde saklar. Oturum açtıktan sonra istekler başarısız olursa Gateway ana makinesinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` değerini ayarlayın. Gemini CLI JSON yanıtları `response` içinden 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 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 kesin üst kaynak yönlendirmesi OpenClaw içinde sabit kodlanmış değildir; Kilo Gateway'e aittir. Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode). ### Paketle gelen diğer sağlayıcı Plugin'leri | Sağlayıcı | Kimlik | Kimlik doğrulama env | Örnek model | | ----------------------- | -------------------------------- | ------------------------------------------------------------ | --------------------------------------------- | | BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` | | Cerebras | `cerebras` | `CEREBRAS_API_KEY` | `cerebras/zai-glm-4.7` | | Cloudflare AI Gateway | `cloudflare-ai-gateway` | `CLOUDFLARE_AI_GATEWAY_API_KEY` | - | | DeepInfra | `deepinfra` | `DEEPINFRA_API_KEY` | `deepinfra/deepseek-ai/DeepSeek-V3.2` | | DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` | `deepseek/deepseek-v4-flash` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | Groq | `groq` | `GROQ_API_KEY` | - | | Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` veya `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` | | Kilo Gateway | `kilocode` | `KILOCODE_API_KEY` | `kilocode/kilo/auto` | | Kimi Coding | `kimi` | `KIMI_API_KEY` veya `KIMICODE_API_KEY` | `kimi/kimi-for-coding` | | MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M2.7` | | Mistral | `mistral` | `MISTRAL_API_KEY` | `mistral/mistral-large-latest` | | Moonshot | `moonshot` | `MOONSHOT_API_KEY` | `moonshot/kimi-k2.6` | | NVIDIA | `nvidia` | `NVIDIA_API_KEY` | `nvidia/nvidia/nemotron-3-super-120b-a12b` | | OpenRouter | `openrouter` | `OPENROUTER_API_KEY` | `openrouter/auto` | | Qianfan | `qianfan` | `QIANFAN_API_KEY` | `qianfan/deepseek-v3.2` | | Qwen Cloud | `qwen` | `QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY` | `qwen/qwen3.5-plus` | | StepFun | `stepfun` / `stepfun-plan` | `STEPFUN_API_KEY` | `stepfun/step-3.5-flash` | | Together | `together` | `TOGETHER_API_KEY` | `together/moonshotai/Kimi-K2.5` | | Venice | `venice` | `VENICE_API_KEY` | - | | Vercel AI Gateway | `vercel-ai-gateway` | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway/anthropic/claude-opus-4.6` | | Volcano Engine (Doubao) | `volcengine` / `volcengine-plan` | `VOLCANO_ENGINE_API_KEY` | `volcengine-plan/ark-code-latest` | | xAI | `xai` | `XAI_API_KEY` | `xai/grok-4.3` | | Xiaomi | `xiaomi` | `XIAOMI_API_KEY` | `xiaomi/mimo-v2-flash` | #### Bilinmesi gereken özel durumlar Uygulama ilişkilendirme başlıklarını ve Anthropic `cache_control` işaretleyicilerini yalnızca doğrulanmış `openrouter.ai` rotalarında uygular. DeepSeek, Moonshot ve ZAI referansları, OpenRouter tarafından yönetilen istem önbelleğe alma için cache-TTL'ye uygundur ancak Anthropic önbellek işaretleyicileri almaz. Proxy tarzı OpenAI uyumlu bir yol olarak, yalnızca yerel OpenAI'ye özgü şekillendirmeyi (`serviceTier`, Responses `store`, istem önbelleği ipuçları, OpenAI akıl yürütme uyumluluğu) atlar. Gemini destekli referanslar yalnızca proxy-Gemini düşünce imzası temizlemesini korur. Gemini destekli referanslar aynı proxy-Gemini temizleme yolunu izler; `kilocode/kilo/auto` ve proxy akıl yürütme desteği olmayan diğer referanslar proxy akıl yürütme enjeksiyonunu atlar. API anahtarı onboarding'i açık metin-only M2.7 sohbet modeli tanımlarını yazar; görüntü anlama, plugin'in sahip olduğu `MiniMax-VL-01` medya sağlayıcısında kalır. Model kimlikleri `nvidia//` ad alanını kullanır (örneğin `nvidia/moonshotai/kimi-k2.5` ile birlikte `nvidia/nvidia/nemotron-...`); seçiciler birebir `/` bileşimini korurken API'ye gönderilen kanonik anahtar tek önekli kalır. xAI Responses yolunu kullanır. `grok-4.3`, paketle gelen varsayılan sohbet modelidir. `/fast` veya `params.fastMode: true`, `grok-3`, `grok-3-mini`, `grok-4` ve `grok-4-0709` değerlerini `*-fast` varyantlarına yeniden yazar. `tool_stream` varsayılan olarak açıktır; `agents.defaults.models["xai/"].params.tool_stream=false` ile devre dışı bırakın. Paketle gelen `cerebras` sağlayıcı plugin'i olarak gelir. GLM `zai-glm-4.7` kullanır; OpenAI uyumlu temel URL `https://api.cerebras.ai/v1` şeklindedir. ## `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. Yalnızca varsayılan temel URL'yi, başlıkları veya model listesini geçersiz kılmak istediğinizde açık `models.providers.` girdileri kullanın. Gateway model yetenek denetimleri açık `models.providers..models[]` meta verilerini de okur. Özel veya proxy modeli görüntü kabul ediyorsa, WebChat ve node kaynaklı ek yollarının görüntüleri text-only medya referansları yerine yerel model girdileri olarak geçirmesi için o modelde `input: ["text", "image"]` ayarlayın. `agents.defaults.models["provider/model"]` yalnızca agent'lar için model görünürlüğünü, takma adları ve model başına meta verileri denetler. Tek başına yeni bir runtime modeli kaydetmez. Özel sağlayıcı modelleri için, en azından eşleşen `id` ile `models.providers..models[]` de ekleyin. ### Moonshot AI (Kimi) Moonshot, paketle gelen bir sağlayıcı plugin'i olarak gelir. Varsayılan olarak yerleşik sağlayıcıyı kullanın ve yalnızca temel URL'yi veya model meta verilerini geçersiz kılmanız gerektiğinde açık bir `models.providers.moonshot` girdisi 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-model-refs:start" - `moonshot/kimi-k2.6` - `moonshot/kimi-k2.5` - `moonshot/kimi-k2-thinking` - `moonshot/kimi-k2-thinking-turbo` - `moonshot/kimi-k2-turbo` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 { 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 Kimi Coding, Moonshot AI'nin Anthropic uyumlu uç noktasını kullanır: - Sağlayıcı: `kimi` - Kimlik doğrulama: `KIMI_API_KEY` - Örnek model: `kimi/kimi-for-coding` ```json5 { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" } }, }, } ``` Eski `kimi/kimi-code` ve `kimi/k2p5`, uyumluluk model kimlikleri olarak kabul edilmeye devam eder ve Kimi'nin kararlı API model kimliğine normalleştirilir. ### 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` ```json5 { agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" } }, }, } ``` İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel `volcengine/*` kataloğu 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 filtresiz kataloğa geri döner. - `volcengine/doubao-seed-1-8-251228` (Doubao Seed 1.8) - `volcengine/doubao-seed-code-preview-251028` - `volcengine/kimi-k2-5-260127` (Kimi K2.5) - `volcengine/glm-4-7-251222` (GLM 4.7) - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K) - `volcengine-plan/ark-code-latest` - `volcengine-plan/doubao-seed-code` - `volcengine-plan/kimi-k2.5` - `volcengine-plan/kimi-k2-thinking` - `volcengine-plan/glm-4.7` ### 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` ```json5 { agents: { defaults: { model: { primary: "byteplus-plan/ark-code-latest" } }, }, } ``` İlk kurulum varsayılan olarak kodlama yüzeyini kullanır, ancak genel `byteplus/*` kataloğu 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 filtresiz kataloğa geri döner. - `byteplus/seed-1-8-251228` (Seed 1.8) - `byteplus/kimi-k2-5-260127` (Kimi K2.5) - `byteplus/glm-4-7-251222` (GLM 4.7) - `byteplus-plan/ark-code-latest` - `byteplus-plan/doubao-seed-code` - `byteplus-plan/kimi-k2.5` - `byteplus-plan/kimi-k2-thinking` - `byteplus-plan/glm-4.7` ### 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` ```json5 { 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 (Ç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` Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçacıkları için [/providers/minimax](/tr/providers/minimax) sayfasına bakın. MiniMax'in Anthropic uyumlu akış yolunda, OpenClaw açıkça ayarlamadığınız sürece düşünmeyi varsayılan olarak devre dışı bırakır ve `/fast on`, `MiniMax-M2.7` değerini `MiniMax-M2.7-highspeed` olarak yeniden yazar. Plugin sahipli yetenek ayrımı: - Metin/sohbet varsayılanları `minimax/MiniMax-M2.7` üzerinde kalır - Görsel oluşturma `minimax/image-01` veya `minimax-portal/image-01` değeridir - Görsel anlama, her iki MiniMax kimlik doğrulama yolunda Plugin sahipli `MiniMax-VL-01` değeridir - Web araması sağlayıcı kimliği `minimax` üzerinde kalır ### LM Studio LM Studio, yerel API'yi kullanan paketlenmiş bir sağlayıcı Plugin olarak gelir: - 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): ```json5 { 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` yollarını, varsayılan olarak çıkarım için `/v1/chat/completions` yolunu kullanır. LM Studio JIT yüklemesi, TTL ve otomatik çıkarma işlemlerinin model yaşam döngüsünü sahiplenmesini istiyorsanız `models.providers.lmstudio.params.preload: false` ayarlayın. Kurulum ve sorun giderme için [/providers/lmstudio](/tr/providers/lmstudio) sayfasına bakın. ### Ollama Ollama, paketlenmiş bir sağlayıcı Plugin olarak gelir ve Ollama'nın yerel API'sini kullanır: - Sağlayıcı: `ollama` - Kimlik doğrulama: Gerekli değil (yerel sunucu) - Örnek model: `ollama/llama3.3` - Kurulum: [https://ollama.com/download](https://ollama.com/download) ```bash # Install Ollama, then pull a model: ollama pull llama3.3 ``` ```json5 { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` Ollama, `OLLAMA_API_KEY` ile etkinleştirdiğinizde yerel olarak `http://127.0.0.1:11434` adresinde algılanır ve paketlenmiş sağlayıcı Plugin, 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](/tr/providers/ollama) sayfasına bakın. ### vLLM vLLM, yerel/kendi barındırılan OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı Plugin olarak gelir: - 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 otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulaması zorunlu kılmıyorsa herhangi bir değer çalışır): ```bash 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): ```json5 { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` Ayrıntılar için [/providers/vllm](/tr/providers/vllm) sayfasına bakın. ### SGLang SGLang, hızlı kendi barındırılan OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı Plugin olarak gelir: - 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 otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulaması zorunlu kılmıyorsa herhangi bir değer çalışır): ```bash 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): ```json5 { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` Ayrıntılar için [/providers/sglang](/tr/providers/sglang) sayfasına bakın. ### Yerel proxy'ler (LM Studio, vLLM, LiteLLM vb.) Örnek (OpenAI uyumlu): ```json5 { 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, }, ], }, }, }, } ``` Özel sağlayıcılar için `reasoning`, `input`, `cost`, `contextWindow` ve `maxTokens` isteğe bağlıdır. Atlandığında OpenClaw varsayılan olarak şunları kullanır: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `contextWindow: 200000` - `maxTokens: 8192` Öneri: proxy/model sınırlarınızla eşleşen açık değerler ayarlayın. - Yerel olmayan uç noktalarda `api: "openai-completions"` için (`baseUrl` boş olmayan ve ana makinesi `api.openai.com` olmayan herhangi bir değer), OpenClaw desteklenmeyen `developer` rolleri nedeniyle sağlayıcı 400 hatalarını önlemek için `compat.supportsDeveloperRole: false` değerini zorunlu kılar. - Proxy tarzı OpenAI uyumlu rotalar, yalnızca yerel OpenAI'ye özgü istek şekillendirmeyi de atlar: `service_tier` yok, Responses `store` yok, Completions `store` yok, istem önbelleği ipuçları yok, OpenAI düşünme uyumluluğu yük şekillendirmesi yok ve gizli OpenClaw atıf başlıkları yok. - Satıcıya özgü alanlara ihtiyaç duyan OpenAI uyumlu Completions proxy'leri için, giden istek gövdesine ek JSON birleştirmek üzere `agents.defaults.models["provider/model"].params.extra_body` (veya `extraBody`) ayarlayın. - vLLM sohbet şablonu denetimleri için `agents.defaults.models["provider/model"].params.chat_template_kwargs` ayarlayın. Paketlenmiş vLLM Plugin, oturum düşünme düzeyi kapalı olduğunda `vllm/nemotron-3-*` için otomatik olarak `enable_thinking: false` ve `force_nonempty_content: true` gönderir. - Yavaş yerel modeller veya uzak LAN/tailnet ana makineleri için `models.providers..timeoutSeconds` ayarlayın. Bu, tüm aracı çalışma zamanı zaman aşımını artırmadan bağlanma, başlıklar, gövde akışı ve toplam korumalı getirme iptali dahil olmak üzere sağlayıcı model HTTP isteği işlemeyi genişletir. - Model sağlayıcı HTTP çağrıları, yapılandırılmış sağlayıcı `baseUrl` ana makine adı için yalnızca `198.18.0.0/15` ve `fc00::/7` içindeki Surge, Clash ve sing-box sahte IP DNS yanıtlarına izin verir. Diğer özel, loopback, link-local ve metadata hedefleri yine de açık bir `models.providers..request.allowPrivateNetwork: true` etkinleştirmesi gerektirir. - `baseUrl` boş/atlanmışsa OpenClaw, varsayılan OpenAI davranışını korur (bu da `api.openai.com` değerine çözümlenir). - Güvenlik için, açık bir `compat.supportsDeveloperRole: true` değeri yerel olmayan `openai-completions` uç noktalarında yine de geçersiz kılınır. - Yerel olmayan uç noktalarda `api: "anthropic-messages"` için (kanonik `anthropic` dışındaki herhangi bir sağlayıcı veya ana makinesi herkese açık bir `api.anthropic.com` uç noktası olmayan özel bir `models.providers.anthropic.baseUrl`), OpenClaw, özel Anthropic uyumlu proxy'lerin desteklenmeyen beta bayraklarını reddetmemesi için `claude-code-20250219`, `interleaved-thinking-2025-05-14` ve OAuth işaretleri gibi örtük Anthropic beta başlıklarını bastırır. Proxy'nizin belirli beta özelliklerine ihtiyacı varsa `models.providers..headers["anthropic-beta"]` değerini açıkça ayarlayın. ## CLI örnekleri ```bash openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` Tam yapılandırma örnekleri için ayrıca bakın: [Yapılandırma](/tr/gateway/configuration). ## İlgili - [Yapılandırma referansı](/tr/gateway/config-agents#agent-defaults) - model yapılandırma anahtarları - [Model yük devri](/tr/concepts/model-failover) - yedek zincirleri ve yeniden deneme davranışı - [Modeller](/tr/concepts/models) - model yapılandırması ve takma adlar - [Sağlayıcılar](/tr/providers) - sağlayıcı bazında kurulum kılavuzları