Gateway

Yapılandırma — araçlar ve özel sağlayıcılar

tools.* config anahtarları ve özel sağlayıcı / temel URL kurulumu. Agent'lar, kanallar ve diğer üst düzey config anahtarları için bkz. Yapılandırma başvurusu.

Araçlar

Araç profilleri

tools.profile, tools.allow/tools.deny öncesinde temel bir izin listesi ayarlar:

Profil	İçerir
`minimal`	Yalnızca `session_status`
`coding`	`group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate`
`messaging`	`group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`
`full`	Kısıtlama yok (ayarlanmamışla aynı)

Araç grupları

Grup	Araçlar
`group:runtime`	`exec`, `process`, `code_execution` (`bash`, `exec` için alias olarak kabul edilir)
`group:fs`	`read`, `write`, `edit`, `apply_patch`
`group:sessions`	`sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status`
`group:memory`	`memory_search`, `memory_get`
`group:web`	`web_search`, `x_search`, `web_fetch`
`group:ui`	`browser`, `canvas`
`group:automation`	`heartbeat_respond`, `cron`, `gateway`
`group:messaging`	`message`
`group:nodes`	`nodes`
`group:agents`	`agents_list`, `update_plan`
`group:media`	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`
`group:openclaw`	Tüm yerleşik araçlar (sağlayıcı Plugin'leri hariç)

`tools.allow` / `tools.deny`

Genel araç izin/ret politikası (ret kazanır). Büyük/küçük harfe duyarsızdır, * joker karakterlerini destekler. Docker sandbox kapalıyken bile uygulanır.

{
  tools: { deny: ["browser", "canvas"] },
}

write ve apply_patch ayrı araç kimlikleridir. allow: ["write"], uyumlu modeller için apply_patch'i de etkinleştirir, ancak deny: ["write"], apply_patch'i reddetmez. Tüm dosya değişikliklerini engellemek için group:fs'yi reddedin veya her değişiklik yapan aracı açıkça listeleyin:

{
  tools: { deny: ["write", "edit", "apply_patch"] },
}

`tools.byProvider`

Belirli sağlayıcılar veya modeller için araçları daha da kısıtlar. Sıra: temel profil → sağlayıcı profili → izin/ret.

{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
      "openai/gpt-5.4": { allow: ["group:fs", "sessions_list"] },
    },
  },
}

`tools.elevated`

Sandbox dışındaki yükseltilmiş exec erişimini denetler:

{
  tools: {
    elevated: {
      enabled: true,
      allowFrom: {
        whatsapp: ["+15555550123"],
        discord: ["1234567890123", "987654321098765432"],
      },
    },
  },
}

Agent başına override (agents.list[].tools.elevated) yalnızca daha fazla kısıtlayabilir.
/elevated on|off|ask|full, durumu oturum başına saklar; satır içi yönergeler tek mesaja uygulanır.
Yükseltilmiş exec, sandboxing'i atlar ve yapılandırılmış çıkış yolunu kullanır (varsayılan olarak gateway, exec hedefi node olduğunda ise node).

`tools.exec`

{
  tools: {
    exec: {
      backgroundMs: 10000,
      timeoutSec: 1800,
      cleanupMs: 1800000,
      notifyOnExit: true,
      notifyOnExitEmptySuccess: false,
      applyPatch: {
        enabled: false,
        allowModels: ["gpt-5.5"],
      },
    },
  },
}

`tools.loopDetection`

Araç döngüsü güvenlik kontrolleri varsayılan olarak devre dışıdır. Algılamayı etkinleştirmek için enabled: true olarak ayarlayın. Ayarlar genel olarak tools.loopDetection içinde tanımlanabilir ve agent başına agents.list[].tools.loopDetection konumunda override edilebilir.

{
  tools: {
    loopDetection: {
      enabled: true,
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
    },
  },
}

historySizenumber

Döngü analizi için tutulan maksimum araç çağrısı geçmişi.

warningThresholdnumber

Uyarılar için tekrarlanan ilerlemesiz kalıp eşiği.

criticalThresholdnumber

Kritik döngüleri engellemek için daha yüksek tekrar eşiği.

globalCircuitBreakerThresholdnumber

Herhangi bir ilerlemesiz çalışma için kesin durdurma eşiği.

detectors.genericRepeatboolean

Aynı araç/aynı argüman çağrılarının tekrarlanmasında uyar.

detectors.knownPollNoProgressboolean

Bilinen poll araçlarında (process.poll, command_status vb.) uyar/engelle.

detectors.pingPongboolean

İlerleme sağlamayan dönüşümlü çift kalıplarında uyar/engelle.

`tools.web`

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "brave_api_key", // or BRAVE_API_KEY env
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
      fetch: {
        enabled: true,
        provider: "firecrawl", // optional; omit for auto-detect
        maxChars: 50000,
        maxCharsCap: 50000,
        maxResponseBytes: 2000000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        maxRedirects: 3,
        readability: true,
        userAgent: "custom-ua",
      },
    },
  },
}

`tools.media`

Gelen medya anlamayı yapılandırır (görüntü/ses/video):

{
  tools: {
    media: {
      concurrency: 2,
      asyncCompletion: {
        directSend: false, // deprecated: completions stay agent-mediated
      },
      audio: {
        enabled: true,
        maxBytes: 20971520,
        scope: {
          default: "deny",
          rules: [{ action: "allow", match: { chatType: "direct" } }],
        },
        models: [
          { provider: "openai", model: "gpt-4o-mini-transcribe" },
          { type: "cli", command: "whisper", args: ["--model", "base", "{{MediaPath}}"] },
        ],
      },
      image: {
        enabled: true,
        timeoutSeconds: 180,
        models: [{ provider: "ollama", model: "gemma4:26b", timeoutSeconds: 300 }],
      },
      video: {
        enabled: true,
        maxBytes: 52428800,
        models: [{ provider: "google", model: "gemini-3-flash-preview" }],
      },
    },
  },
}

Medya modeli girdi alanları

Sağlayıcı girdisi (type: "provider" veya atlanmış):

provider: API sağlayıcısı kimliği (openai, anthropic, google/gemini, groq vb.)
model: model kimliği geçersiz kılma değeri
profile / preferredProfile: auth-profiles.json profil seçimi

CLI girdisi (type: "cli"):

command: çalıştırılacak yürütülebilir dosya
args: şablonlanmış argümanlar ({{MediaPath}}, {{Prompt}}, {{MaxChars}} vb. desteklenir; openclaw doctor --fix, kullanımdan kaldırılmış {input} yer tutucularını {{MediaPath}} değerine taşır)

Ortak alanlar:

capabilities: isteğe bağlı liste (image, audio, video). Varsayılanlar: openai/anthropic/minimax → görüntü, google → görüntü+ses+video, groq → ses.
prompt, maxChars, maxBytes, timeoutSeconds, language: girdi başına geçersiz kılmalar.
tools.media.image.timeoutSeconds ve eşleşen görüntü modeli timeoutSeconds girdileri, ajan açık image aracını çağırdığında da uygulanır.
Hatalar sonraki girdiye geri döner.

Sağlayıcı kimlik doğrulaması standart sırayı izler: auth-profiles.json → ortam değişkenleri → models.providers.*.apiKey.

Zaman uyumsuz tamamlama alanları:

asyncCompletion.directSend: kullanımdan kaldırılmış uyumluluk bayrağı. Tamamlanan zaman uyumsuz medya görevleri, ajanın sonucu alması, kullanıcıya nasıl söyleyeceğine karar vermesi ve kaynak teslimi gerektirdiğinde mesaj aracını kullanması için istek sahibi oturumu aracılı kalır.

`tools.agentToAgent`

{
  tools: {
    agentToAgent: {
      enabled: false,
      allow: ["home", "work"],
    },
  },
}

`tools.sessions`

Oturum araçları (sessions_list, sessions_history, sessions_send) tarafından hangi oturumların hedeflenebileceğini denetler.

Varsayılan: tree (geçerli oturum + onun başlattığı alt ajanlar gibi oturumlar).

{
  tools: {
    sessions: {
      // "self" | "tree" | "agent" | "all"
      visibility: "tree",
    },
  },
}

Görünürlük kapsamları

self: yalnızca geçerli oturum anahtarı.
tree: geçerli oturum + geçerli oturum tarafından başlatılan oturumlar (alt ajanlar).
agent: geçerli ajan kimliğine ait herhangi bir oturum (aynı ajan kimliği altında gönderici başına oturumlar çalıştırıyorsanız diğer kullanıcıları içerebilir).
all: herhangi bir oturum. Ajanlar arası hedefleme yine de tools.agentToAgent gerektirir.
Sandbox sınırlaması: geçerli oturum sandbox içinde olduğunda ve agents.defaults.sandbox.sessionToolsVisibility="spawned" olduğunda, tools.sessions.visibility="all" olsa bile görünürlük tree olarak zorlanır.

`tools.sessions_spawn`

sessions_spawn için satır içi ek desteğini denetler.

{
  tools: {
    sessions_spawn: {
      attachments: {
        enabled: false, // opt-in: set true to allow inline file attachments
        maxTotalBytes: 5242880, // 5 MB total across all files
        maxFiles: 50,
        maxFileBytes: 1048576, // 1 MB per file
        retainOnSessionKeep: false, // keep attachments when cleanup="keep"
      },
    },
  },
}

Ek notları

Ekler yalnızca runtime: "subagent" için desteklenir. ACP runtime bunları reddeder.
Dosyalar alt çalışma alanında .openclaw/attachments/<uuid>/ konumuna bir .manifest.json ile somutlaştırılır.
Ek içeriği transcript kalıcılığından otomatik olarak redakte edilir.
Base64 girdileri sıkı alfabe/dolgu kontrolleri ve kod çözme öncesi boyut koruması ile doğrulanır.
Dosya izinleri dizinler için 0700, dosyalar için 0600 olur.
Temizleme cleanup politikasını izler: delete ekleri her zaman kaldırır; keep bunları yalnızca retainOnSessionKeep: true olduğunda saklar.

`tools.experimental`

Deneysel yerleşik araç bayrakları. Sıkı-agentic GPT-5 otomatik etkinleştirme kuralı uygulanmadıkça varsayılan olarak kapalıdır.

{
  tools: {
    experimental: {
      planTool: true, // enable experimental update_plan
    },
  },
}

planTool: önemsiz olmayan çok adımlı iş takibi için yapılandırılmış update_plan aracını etkinleştirir.
Varsayılan: Bir OpenAI veya OpenAI Codex GPT-5 ailesi çalıştırması için agents.defaults.embeddedPi.executionContract (veya ajan başına geçersiz kılma) "strict-agentic" olarak ayarlanmadıkça false. Aracı bu kapsam dışında zorla açmak için true, strict-agentic GPT-5 çalıştırmaları için bile kapalı tutmak için false ayarlayın.
Etkinleştirildiğinde, sistem promptu da kullanım yönergeleri ekler; böylece model bunu yalnızca önemli işler için kullanır ve en fazla bir adımı in_progress tutar.

`agents.defaults.subagents`

{
  agents: {
    defaults: {
      subagents: {
        allowAgents: ["research"],
        model: "minimax/MiniMax-M2.7",
        maxConcurrent: 8,
        runTimeoutSeconds: 900,
        archiveAfterMinutes: 60,
      },
    },
  },
}

model: oluşturulan alt ajanlar için varsayılan model. Atlanırsa alt ajanlar çağıranın modelini devralır.
allowAgents: istek yapan ajan kendi subagents.allowAgents değerini ayarlamadığında sessions_spawn için hedef ajan kimliklerinin varsayılan izin listesi (["*"] = herhangi biri; varsayılan: yalnızca aynı ajan).
runTimeoutSeconds: araç çağrısı runTimeoutSeconds değerini atladığında sessions_spawn için varsayılan zaman aşımı (saniye). 0, zaman aşımı yok anlamına gelir.
Alt ajan başına araç politikası: tools.subagents.tools.allow / tools.subagents.tools.deny.

Özel sağlayıcılar ve temel URL'ler

OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılandırmada models.providers üzerinden veya ~/.openclaw/agents/<agentId>/agent/models.json içinde ekleyin.

{
  models: {
    mode: "merge", // merge (default) | replace
    providers: {
      "custom-proxy": {
        baseUrl: "http://localhost:4000/v1",
        apiKey: "LITELLM_KEY",
        api: "openai-completions", // openai-completions | openai-responses | anthropic-messages | google-generative-ai
        models: [
          {
            id: "llama-3.1-8b",
            name: "Llama 3.1 8B",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            contextTokens: 96000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}

Kimlik doğrulama ve birleştirme önceliği

Özel kimlik doğrulama gereksinimleri için authHeader: true + headers kullanın.
Ajan yapılandırma kökünü OPENCLAW_AGENT_DIR (veya eski bir ortam değişkeni takma adı olan PI_CODING_AGENT_DIR) ile geçersiz kılın.
Eşleşen sağlayıcı kimlikleri için birleştirme önceliği:
- Boş olmayan ajan models.json baseUrl değerleri kazanır.
- Boş olmayan ajan apiKey değerleri yalnızca bu sağlayıcı mevcut yapılandırma/auth-profile bağlamında SecretRef tarafından yönetilmiyorsa kazanır.
- SecretRef tarafından yönetilen sağlayıcı apiKey değerleri, çözümlenen sırları kalıcılaştırmak yerine kaynak işaretleyicilerinden (env başvuruları için ENV_VAR_NAME, dosya/exec başvuruları için secretref-managed) yenilenir.
- SecretRef tarafından yönetilen sağlayıcı header değerleri, kaynak işaretleyicilerinden (env başvuruları için secretref-env:ENV_VAR_NAME, dosya/exec başvuruları için secretref-managed) yenilenir.
- Boş veya eksik ajan apiKey/baseUrl, yapılandırmadaki models.providers değerine geri döner.
- Eşleşen model contextWindow/maxTokens, açık yapılandırma ile örtük katalog değerleri arasındaki daha yüksek değeri kullanır.
- Eşleşen model contextTokens, mevcut olduğunda açık bir runtime sınırını korur; yerel model meta verilerini değiştirmeden etkili bağlamı sınırlamak için bunu kullanın.
- Yapılandırmanın models.json dosyasını tamamen yeniden yazmasını istediğinizde models.mode: "replace" kullanın.
- İşaretleyici kalıcılığı kaynak otoritelidir: işaretleyiciler, çözümlenmiş runtime sır değerlerinden değil etkin kaynak yapılandırma snapshot'ından (çözümleme öncesi) yazılır.

Sağlayıcı alan ayrıntıları

Üst düzey katalog

models.mode: sağlayıcı kataloğu davranışı (merge veya replace).
models.providers: sağlayıcı kimliğine göre anahtarlanan özel sağlayıcı haritası.
- Güvenli düzenlemeler: eklemeli güncellemeler için openclaw config set models.providers.<id> '<json>' --strict-json --merge veya openclaw config set models.providers.<id>.models '<json-array>' --strict-json --merge kullanın. config set, --replace iletmediğiniz sürece yıkıcı değiştirmeleri reddeder.

Sağlayıcı bağlantısı ve kimlik doğrulama

models.providers.*.api: istek bağdaştırıcısı (openai-completions, openai-responses, anthropic-messages, google-generative-ai vb.). MLX, vLLM, SGLang ve çoğu OpenAI uyumlu yerel sunucu gibi kendi barındırılan /v1/chat/completions backend'leri için openai-completions kullanın. baseUrl olan ancak api olmayan özel sağlayıcı varsayılan olarak openai-completions kullanır; openai-responses değerini yalnızca backend /v1/responses desteklediğinde ayarlayın.
models.providers.*.apiKey: sağlayıcı kimlik bilgisi (SecretRef/env ikamesi tercih edilir).
models.providers.*.auth: kimlik doğrulama stratejisi (api-key, token, oauth, aws-sdk).
models.providers.*.contextWindow: model girdisi contextWindow ayarlamadığında bu sağlayıcı altındaki modeller için varsayılan yerel bağlam penceresi.
models.providers.*.contextTokens: model girdisi contextTokens ayarlamadığında bu sağlayıcı altındaki modeller için varsayılan etkili runtime bağlam sınırı.
models.providers.*.maxTokens: model girdisi maxTokens ayarlamadığında bu sağlayıcı altındaki modeller için varsayılan çıktı token sınırı.
models.providers.*.timeoutSeconds: bağlantı, header'lar, gövde ve toplam istek iptal işleme dahil olmak üzere, sağlayıcı başına isteğe bağlı model HTTP istek zaman aşımı, saniye cinsinden.
models.providers.*.injectNumCtxForOpenAICompat: Ollama + openai-completions için isteklere options.num_ctx enjekte eder (varsayılan: true).
models.providers.*.authHeader: gerektiğinde kimlik bilgisi taşımayı Authorization header'ında zorlar.
models.providers.*.baseUrl: yukarı akış API temel URL'si.
models.providers.*.headers: proxy/kiracı yönlendirmesi için ek statik header'lar.

İstek taşıma geçersiz kılmaları

models.providers.*.request: model sağlayıcı HTTP istekleri için taşıma geçersiz kılmaları.

request.headers: ek header'lar (sağlayıcı varsayılanlarıyla birleştirilir). Değerler SecretRef kabul eder.
request.auth: kimlik doğrulama stratejisi geçersiz kılma. Modlar: "provider-default" (sağlayıcının yerleşik kimlik doğrulamasını kullan), "authorization-bearer" (token ile), "header" (headerName, value, isteğe bağlı prefix ile).
request.proxy: HTTP proxy geçersiz kılma. Modlar: "env-proxy" (HTTP_PROXY/HTTPS_PROXY ortam değişkenlerini kullan), "explicit-proxy" (url ile). Her iki mod da isteğe bağlı bir tls alt nesnesi kabul eder.
request.tls: doğrudan bağlantılar için TLS geçersiz kılma. Alanlar: ca, cert, key, passphrase (tümü SecretRef kabul eder), serverName, insecureSkipVerify.
request.allowPrivateNetwork: true olduğunda, DNS özel, CGNAT veya benzer aralıklara çözümlendiğinde sağlayıcı HTTP fetch koruması aracılığıyla baseUrl için HTTPS'e izin verir (güvenilir kendi barındırılan OpenAI uyumlu uç noktalar için operatör tercihi). localhost, 127.0.0.1 ve [::1] gibi loopback model sağlayıcı stream URL'lerine, bu açıkça false olarak ayarlanmadıkça otomatik olarak izin verilir; LAN, tailnet ve özel DNS host'ları hâlâ tercih gerektirir. WebSocket, header'lar/TLS için aynı request değerini kullanır ancak bu fetch SSRF kapısını kullanmaz. Varsayılan false.

Model kataloğu girdileri

models.providers.*.models: açık sağlayıcı model kataloğu girdileri.
models.providers.*.models.*.input: model giriş modaliteleri. Yalnızca metin modelleri için ["text"], yerel görüntü/vision modelleri için ["text", "image"] kullanın. Görsel ekleri yalnızca seçilen model görsel yetenekli olarak işaretlendiğinde ajan dönüşlerine enjekte edilir.
models.providers.*.models.*.contextWindow: yerel model bağlam penceresi meta verileri. Bu, ilgili model için sağlayıcı düzeyindeki contextWindow değerini geçersiz kılar.
models.providers.*.models.*.contextTokens: isteğe bağlı runtime bağlam sınırı. Bu, sağlayıcı düzeyindeki contextTokens değerini geçersiz kılar; modelin yerel contextWindow değerinden daha küçük etkili bir bağlam bütçesi istediğinizde bunu kullanın; openclaw models list, farklı olduklarında her iki değeri de gösterir.
models.providers.*.models.*.compat.supportsDeveloperRole: isteğe bağlı uyumluluk ipucu. Yerel olmayan boş olmayan bir baseUrl (host api.openai.com değil) ile api: "openai-completions" için OpenClaw runtime sırasında bunu false olmaya zorlar. Boş/atlanmış baseUrl, varsayılan OpenAI davranışını korur.
models.providers.*.models.*.compat.requiresStringContent: yalnızca string kullanan OpenAI uyumlu chat uç noktaları için isteğe bağlı uyumluluk ipucu. true olduğunda OpenClaw, isteği göndermeden önce saf metin messages[].content dizilerini düz string'lere indirger.

Amazon Bedrock keşfi

plugins.entries.amazon-bedrock.config.discovery: Bedrock otomatik keşif ayarları kökü.
plugins.entries.amazon-bedrock.config.discovery.enabled: örtük keşfi açar/kapatır.
plugins.entries.amazon-bedrock.config.discovery.region: keşif için AWS bölgesi.
plugins.entries.amazon-bedrock.config.discovery.providerFilter: hedefli keşif için isteğe bağlı sağlayıcı kimliği filtresi.
plugins.entries.amazon-bedrock.config.discovery.refreshInterval: keşif yenilemesi için yoklama aralığı.
plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow: keşfedilen modeller için geri dönüş bağlam penceresi.
plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens: keşfedilen modeller için geri dönüş maksimum çıktı token'ları.

Etkileşimli özel sağlayıcı ilk katılımı, GPT-4o, Claude, Gemini, Qwen-VL, LLaVA, Pixtral, InternVL, Mllama, MiniCPM-V ve GLM-4V gibi yaygın vision model kimlikleri için görsel girdisini çıkarır ve bilinen yalnızca metin aileleri için ek soruyu atlar. Bilinmeyen model kimlikleri yine de görsel desteği için sorar. Etkileşimsiz ilk katılım aynı çıkarımı kullanır; görsel yetenekli meta verileri zorlamak için --custom-image-input, yalnızca metin meta verilerini zorlamak için --custom-text-input iletin.

Sağlayıcı örnekleri

Cerebras (GLM 4.7 / GPT OSS)

Paketlenmiş cerebras sağlayıcı Plugin'i bunu openclaw onboard --auth-choice cerebras-api-key ile yapılandırabilir. Açık sağlayıcı yapılandırmasını yalnızca varsayılanları geçersiz kılarken kullanın.

{
  env: { CEREBRAS_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: {
        primary: "cerebras/zai-glm-4.7",
        fallbacks: ["cerebras/gpt-oss-120b"],
      },
      models: {
        "cerebras/zai-glm-4.7": { alias: "GLM 4.7 (Cerebras)" },
        "cerebras/gpt-oss-120b": { alias: "GPT OSS 120B (Cerebras)" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      cerebras: {
        baseUrl: "https://api.cerebras.ai/v1",
        apiKey: "${CEREBRAS_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "zai-glm-4.7", name: "GLM 4.7 (Cerebras)" },
          { id: "gpt-oss-120b", name: "GPT OSS 120B (Cerebras)" },
        ],
      },
    },
  },
}

Cerebras için cerebras/zai-glm-4.7; doğrudan Z.AI için zai/glm-4.7 kullanın.

Kimi Coding

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

Anthropic uyumlu, yerleşik sağlayıcı. Kısayol: openclaw onboard --auth-choice kimi-code-api-key.

Local models (LM Studio)

Bkz. Yerel Modeller. TL;DR: ciddi donanımda LM Studio Responses API üzerinden büyük bir yerel model çalıştırın; yedek seçenek için barındırılan modelleri birleştirilmiş halde tutun.

MiniMax M2.7 (direct)

{
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2.7" },
      models: {
        "minimax/MiniMax-M2.7": { alias: "Minimax" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

MINIMAX_API_KEY ayarlayın. Kısayollar: openclaw onboard --auth-choice minimax-global-api veya openclaw onboard --auth-choice minimax-cn-api. Model kataloğu varsayılan olarak yalnızca M2.7 kullanır. Anthropic uyumlu akış yolunda OpenClaw, thinking değerini açıkça kendiniz ayarlamadığınız sürece MiniMax düşünmeyi varsayılan olarak devre dışı bırakır. /fast on veya params.fastMode: true, MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.

Moonshot AI (Kimi)

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
      models: { "moonshot/kimi-k2.6": { alias: "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",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
        ],
      },
    },
  },
}

Çin uç noktası için: baseUrl: "https://api.moonshot.cn/v1" veya openclaw onboard --auth-choice moonshot-api-key-cn.

Yerel Moonshot uç noktaları, paylaşılan openai-completions aktarımı üzerinde akış kullanım uyumluluğunu duyurur ve OpenClaw bunu yalnızca yerleşik sağlayıcı kimliği yerine uç nokta yeteneklerine göre belirler.

OpenCode

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

OPENCODE_API_KEY (veya OPENCODE_ZEN_API_KEY) ayarlayın. Zen kataloğu için opencode/... referanslarını veya Go kataloğu için opencode-go/... referanslarını kullanın. Kısayol: openclaw onboard --auth-choice opencode-zen veya openclaw onboard --auth-choice opencode-go.

Synthetic (Anthropic-compatible)

{
  env: { SYNTHETIC_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" },
      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "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",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 192000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

Temel URL /v1 içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: openclaw onboard --auth-choice synthetic-api-key.

Z.AI (GLM-4.7)

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} },
    },
  },
}

ZAI_API_KEY ayarlayın. z.ai/* ve z-ai/* kabul edilen takma adlardır. Kısayol: openclaw onboard --auth-choice zai-api-key.

Genel uç nokta: https://api.z.ai/api/paas/v4
Kodlama uç noktası (varsayılan): https://api.z.ai/api/coding/paas/v4
Genel uç nokta için temel URL geçersiz kılmasıyla özel bir sağlayıcı tanımlayın.

İlgili

Yapılandırma — aracılar
Yapılandırma — kanallar
Yapılandırma referansı — diğer üst düzey anahtarlar
Araçlar ve Pluginler

# Araçlar

# Araç profilleri

# Araç grupları

# tools.allow / tools.deny

# tools.byProvider

# tools.elevated

# tools.exec

# tools.loopDetection

# tools.web

# tools.media

# tools.agentToAgent

# tools.sessions

# tools.sessions_spawn

# tools.experimental

# agents.defaults.subagents

# Özel sağlayıcılar ve temel URL'ler

# Sağlayıcı alan ayrıntıları

# Sağlayıcı örnekleri

# İlgili

Araçlar

Araç profilleri

Araç grupları

`tools.allow` / `tools.deny`

`tools.byProvider`

`tools.elevated`

`tools.exec`

`tools.loopDetection`

`tools.web`

`tools.media`

`tools.agentToAgent`

`tools.sessions`

`tools.sessions_spawn`

`tools.experimental`

`agents.defaults.subagents`

Özel sağlayıcılar ve temel URL'ler

Sağlayıcı alan ayrıntıları

Sağlayıcı örnekleri

İlgili