Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
tools.* yapılandırma anahtarları ve özel sağlayıcı / temel URL kurulumu. Agent’lar, kanallar ve diğer üst düzey yapılandırma anahtarları için bkz. Yapılandırma başvurusu.
Araçlar
Araç profilleri
tools.profile, tools.allow/tools.deny öncesinde bir temel izin listesi ayarlar:
Yerel ilk kurulum, ayarlanmamış olduğunda yeni yerel yapılandırmaları varsayılan olarak
tools.profile: "coding" yapar (mevcut açık profiller korunur).| 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ış ile aynı) |
Araç grupları
| Grup | Araçlar |
|---|---|
group:runtime | exec, process, code_execution (bash, exec için bir takma ad 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’lerini hariç tutar) |
tools.allow / tools.deny
Küresel araç izin/ret ilkesi (ret kazanır). Büyük/küçük harfe duyarsızdır, * joker karakterlerini destekler. Docker sanal alanı kapalıyken bile uygulanır.
write ve apply_patch ayrı araç kimlikleridir. allow: ["write"], uyumlu modeller için apply_patch aracını da etkinleştirir, ancak deny: ["write"], apply_patch aracını reddetmez. Tüm dosya değişikliklerini engellemek için group:fs öğesini reddedin veya her değişiklik yapan aracı açıkça listeleyin:
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.toolsBySender
Belirli bir istek sahibi kimliği için araçları kısıtlar. Bu, kanal erişim denetiminin üzerine eklenen katmanlı savunmadır; gönderen değerleri mesaj metninden değil, kanal adaptöründen gelmelidir.
channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> veya "*". Kanal kimlikleri kanonik OpenClaw kimlikleridir; teams gibi takma adlar msteams olarak normalleştirilir. Eski öneksiz anahtarlar yalnızca id: olarak kabul edilir. Eşleştirme sırası channel+id, id, e164, username, name ve ardından joker karakterdir.
Agent başına agents.list[].tools.toolsBySender, boş bir {} ilkesiyle bile eşleştiğinde küresel gönderen eşleşmesini geçersiz kılar.
tools.elevated
Sanal alan dışındaki yükseltilmiş exec erişimini denetler:
- Agent başına geçersiz kılma (
agents.list[].tools.elevated) yalnızca daha fazla kısıtlayabilir. /elevated on|off|ask|fulldurumu oturum başına saklar; satır içi yönergeler tek bir mesaja uygulanır.- Yükseltilmiş
exec, sanal alanı atlar ve yapılandırılmış kaçış yolunu kullanır (varsayılan olarakgateway, exec hedefinodeolduğunda isenode).
tools.exec
tools.loopDetection
Araç döngüsü güvenlik denetimleri varsayılan olarak devre dışıdır. Algılamayı etkinleştirmek için enabled: true ayarlayın. Ayarlar genel olarak tools.loopDetection içinde tanımlanabilir ve ajan bazında agents.list[].tools.loopDetection içinde geçersiz kılınabilir.
Döngü analizi için saklanan en fazla araç çağrısı geçmişi.
Uyarılar için tekrarlayan ilerleme sağlamayan desen eşiği.
Kritik döngüleri engellemek için daha yüksek tekrarlama eşiği.
İlerleme sağlamayan herhangi bir çalışma için kesin durdurma eşiği.
Aynı araç/aynı bağımsız değişkenlerle tekrarlanan çağrılarda uyar.
Bilinen yoklama araçlarında (
process.poll, command_status vb.) uyar/engelle.Dönüşümlü ilerleme sağlamayan ikili desenlerde uyar/engelle.
tools.web
tools.media
Gelen medya anlama işlevini yapılandırır (görüntü/ses/video):
Media model entry fields
Media model entry fields
Sağlayıcı girdisi (
type: "provider" veya belirtilmezse):provider: API sağlayıcı kimliği (openai,anthropic,google/gemini,groqvb.)model: model kimliği geçersiz kılmasıprofile/preferredProfile:auth-profiles.jsonprofil seçimi
type: "cli"):command: çalıştırılacak yürütülebilir dosyaargs: şablonlu bağımsız değişkenler ({{MediaPath}},{{Prompt}},{{MaxChars}}vb. desteklenir;openclaw doctor --fix, kullanımdan kaldırılmış{input}yer tutucularını{{MediaPath}}olarak taşır)
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.timeoutSecondsve eşleşen görüntü modelitimeoutSecondsgirdileri, ajan açıkimagearacını çağırdığında da uygulanır.- Hatalar bir sonraki girdiye geri döner.
auth-profiles.json → env vars → models.providers.*.apiKey.Eşzamansız tamamlama alanları:asyncCompletion.directSend: kullanımdan kaldırılmış uyumluluk bayrağı. Tamamlanan eşzamansız medya görevleri, ajanın sonucu alması, kullanıcıya nasıl söyleyeceğine karar vermesi ve kaynak teslimatı gerektirdiğinde mesaj aracını kullanması için istekte bulunan oturum aracılı kalır.
tools.agentToAgent
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 + alt ajanlar gibi onun tarafından başlatılan oturumlar).
Visibility scopes
Visibility scopes
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 oturum çalıştırıyorsanız diğer kullanıcıları içerebilir).all: herhangi bir oturum. Ajanlar arası hedefleme yine detools.agentToAgentgerektirir.- Korumalı alan sınırlaması: geçerli oturum korumalı alandaysa ve
agents.defaults.sandbox.sessionToolsVisibility="spawned"ise,tools.sessions.visibility="all"olsa bile görünürlüktreeolmaya zorlanır.
tools.sessions_spawn
sessions_spawn için satır içi ek desteğini denetler.
Ek notları
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.jsonile oluşturulur. - Ek içeriği transcript kalıcılığından otomatik olarak redakte edilir.
- Base64 girdileri katı alfabe/doldurma denetimleri ve kod çözme öncesi boyut koruması ile doğrulanır.
- Dosya izinleri dizinler için
0700, dosyalar için0600olur. - Temizleme
cleanuppolitikasını izler:deleteekleri her zaman kaldırır;keepbunları yalnızcaretainOnSessionKeep: trueolduğunda korur.
tools.experimental
Deneysel yerleşik araç bayrakları. Katı agentic GPT-5 otomatik etkinleştirme kuralı uygulanmadıkça varsayılan olarak kapalıdır.
planTool: önemsiz olmayan çok adımlı iş takibi için yapılandırılmışupdate_planaracı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çafalse. Aracı bu kapsam dışında zorla açmak içintrue, katı agentic GPT-5 çalıştırmalarında bile kapalı tutmak içinfalseayarlayın. - Etkinleştirildiğinde sistem istemi, modelin bunu yalnızca kapsamlı işler için kullanması ve en fazla bir adımı
in_progresstutması için kullanım rehberliği de ekler.
agents.defaults.subagents
model: oluşturulan alt ajanlar için varsayılan model. Atlanırsa alt ajanlar çağıranın modelini devralır.allowAgents: istekte bulunan ajan kendisubagents.allowAgentsdeğerini ayarlamadığındasessions_spawniçin hedef ajan kimliklerinin varsayılan izin listesi (["*"]= herhangi biri; varsayılan: yalnızca aynı ajan).runTimeoutSeconds: araç çağrısırunTimeoutSecondsdeğerini atladığındasessions_spawniçin varsayılan zaman aşımı (saniye).0, zaman aşımı yok anlamına gelir.announceTimeoutMs: Gatewayagentduyuru teslim denemeleri için çağrı başına zaman aşımı (milisaniye). Varsayılan:120000. Geçici yeniden denemeler toplam duyuru beklemesini yapılandırılmış tek bir zaman aşımından daha uzun hale getirebilir.- Alt ajan başına araç politikası:
tools.subagents.tools.allow/tools.subagents.tools.deny.
Özel sağlayıcılar ve taban URL’ler
OpenClaw yerleşik model kataloğunu kullanır. Özel sağlayıcıları yapılandırmadamodels.providers üzerinden veya ~/.openclaw/agents/<agentId>/agent/models.json içinde ekleyin.
Kimlik doğrulama ve birleştirme önceliği
Kimlik doğrulama ve birleştirme önceliği
- Özel kimlik doğrulama ihtiyaçları için
authHeader: true+headerskullanın. - Ajan yapılandırma kökünü
OPENCLAW_AGENT_DIR(veya eski ortam değişkeni takma adı olanPI_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.jsonbaseUrldeğerleri kazanır. - Boş olmayan ajan
apiKeydeğerleri yalnızca bu sağlayıcı geçerli yapılandırma/auth-profile bağlamında SecretRef tarafından yönetilmiyorsa kazanır. - SecretRef tarafından yönetilen sağlayıcı
apiKeydeğerleri, çözümlenmiş gizli değerleri kalıcı hale getirmek yerine kaynak işaretçilerinden (ENV_VAR_NAMEortam ref’leri için,secretref-manageddosya/exec ref’leri için) yenilenir. - SecretRef tarafından yönetilen sağlayıcı başlık değerleri, kaynak işaretçilerinden (
secretref-env:ENV_VAR_NAMEortam ref’leri için,secretref-manageddosya/exec ref’leri için) yenilenir. - Boş veya eksik ajan
apiKey/baseUrl, yapılandırmadakimodels.providersdeğerine geri düşer. - 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 çalışma zamanı üst 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.jsondosyasını tamamen yeniden yazmasını istediğinizdemodels.mode: "replace"kullanın. - İşaretçi kalıcılığı kaynak yetkilidir: işaretçiler çözümlenmiş çalışma zamanı gizli değerlerinden değil, etkin kaynak yapılandırma anlık görüntüsünden (çözümleme öncesi) yazılır.
- Boş olmayan ajan
Sağlayıcı alanı ayrıntıları
Üst düzey katalog
Üst düzey katalog
models.mode: sağlayıcı katalog davranışı (mergeveyareplace).models.providers: sağlayıcı kimliğine göre anahtarlanmış özel sağlayıcı haritası.- Güvenli düzenlemeler: eklemeli güncellemeler için
openclaw config set models.providers.<id> '<json>' --strict-json --mergeveyaopenclaw config set models.providers.<id>.models '<json-array>' --strict-json --mergekullanın.config set,--replacegeçmediğiniz sürece yıkıcı değiştirmeleri reddeder.
- Güvenli düzenlemeler: eklemeli güncellemeler için
Sağlayıcı bağlantısı ve kimlik doğrulama
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-aivb.). MLX, vLLM, SGLang ve çoğu OpenAI uyumlu yerel sunucu gibi kendi kendine barındırılan/v1/chat/completionsarka uçları içinopenai-completionskullanın.baseUrldeğerine sahip ancakapideğeri olmayan özel sağlayıcı varsayılan olarakopenai-completionskullanır; yalnızca arka uç/v1/responsesdesteklediğindeopenai-responsesayarlayın.models.providers.*.apiKey: sağlayıcı kimlik bilgisi (SecretRef/ortam değişkeni ikamesini tercih edin).models.providers.*.auth: kimlik doğrulama stratejisi (api-key,token,oauth,aws-sdk).models.providers.*.contextWindow: model girdisicontextWindowayarlamadığında bu sağlayıcı altındaki modeller için varsayılan yerel bağlam penceresi.models.providers.*.contextTokens: model girdisicontextTokensayarlamadığında bu sağlayıcı altındaki modeller için varsayılan etkili çalışma zamanı bağlam üst sınırı.models.providers.*.maxTokens: model girdisimaxTokensayarlamadığında bu sağlayıcı altındaki modeller için varsayılan çıktı token üst sınırı.models.providers.*.timeoutSeconds: bağlantı, başlıklar, gövde ve toplam istek iptal işleme dahil olmak üzere sağlayıcı başına isteğe bağlı model HTTP isteği zaman aşımı, saniye cinsinden.models.providers.*.injectNumCtxForOpenAICompat: Ollama +openai-completionsiçin isteklereoptions.num_ctxenjekte eder (varsayılan:true).models.providers.*.authHeader: gerektiğinde kimlik bilgisi aktarımınıAuthorizationbaşlığında zorlar.models.providers.*.baseUrl: yukarı akış API taban URL’si.models.providers.*.headers: proxy/kiracı yönlendirmesi için ek statik başlıklar.
İstek aktarımı geçersiz kılmaları
İstek aktarımı geçersiz kılmaları
models.providers.*.request: model sağlayıcı HTTP istekleri için aktarım geçersiz kılmaları.request.headers: ek başlıklar (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"(tokenile),"header"(headerName,value, isteğe bağlıprefixile).request.proxy: HTTP proxy geçersiz kılma. Modlar:"env-proxy"(HTTP_PROXY/HTTPS_PROXYortam değişkenlerini kullan),"explicit-proxy"(urlile). Her iki mod da isteğe bağlı birtlsalt 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:trueolduğunda, DNS özel, CGNAT veya benzer aralıklara çözümlendiğindebaseUrliçin HTTPS’ye sağlayıcı HTTP fetch koruması üzerinden izin verir (güvenilen, kendi kendine barındırılan OpenAI uyumlu uç noktalar için operatörün açık seçimi).localhost,127.0.0.1ve[::1]gibi loopback model sağlayıcı akış URL’lerine, bu açıkçafalseolarak ayarlanmadığı sürece otomatik olarak izin verilir; LAN, tailnet ve özel DNS ana bilgisayarları yine de açık seçim gerektirir. WebSocket başlıklar/TLS için aynırequestdeğerini kullanır, ancak bu fetch SSRF geçidini kullanmaz. Varsayılanfalse.
Model katalog girdileri
Model katalog girdileri
models.providers.*.models: açık sağlayıcı model katalog girdileri.models.providers.*.models.*.input: model girdi modaliteleri. Yalnızca metin modelleri için["text"], yerel görüntü/vision modelleri için["text", "image"]kullanın. Görüntü ekleri yalnızca seçili model görüntü yetenekli olarak işaretlendiğinde ajan turlarına enjekte edilir.models.providers.*.models.*.contextWindow: yerel model bağlam penceresi meta verileri. Bu, söz konusu model için sağlayıcı düzeyicontextWindowdeğerini geçersiz kılar.models.providers.*.models.*.contextTokens: isteğe bağlı çalışma zamanı bağlam üst sınırı. Bu, sağlayıcı düzeyicontextTokensdeğerini geçersiz kılar; modelin yerelcontextWindowdeğerinden daha küçük etkili bir bağlam bütçesi istediğinizde bunu kullanın;openclaw models list, farklı olduklarında iki değeri de gösterir.models.providers.*.models.*.compat.supportsDeveloperRole: isteğe bağlı uyumluluk ipucu. Yerel olmayan, boş olmayan birbaseUrl(ana bilgisayarapi.openai.comdeğil) ileapi: "openai-completions"için OpenClaw bunu çalışma zamanındafalsedeğerine zorlar. Boş/atlanmışbaseUrl, varsayılan OpenAI davranışını korur.models.providers.*.models.*.compat.requiresStringContent: yalnızca dize kullanan OpenAI uyumlu chat uç noktaları için isteğe bağlı uyumluluk ipucu.trueolduğunda OpenClaw, saf metinmessages[].contentdizilerini isteği göndermeden önce düz dizelere düzleştirir.models.providers.*.models.*.compat.strictMessageKeys: katı OpenAI uyumlu chat uç noktaları için isteğe bağlı uyumluluk ipucu.trueolduğunda OpenClaw, giden Chat Completions ileti nesnelerini isteği göndermeden öncerolevecontentalanlarına indirger.models.providers.*.models.*.compat.thinkingFormat: isteğe bağlı düşünme yükü ipucu. Üst düzeyenable_thinkingiçin"qwen"veya vLLM gibi istek düzeyi chat-template kwargs destekleyen Qwen ailesi OpenAI uyumlu sunuculardachat_template_kwargs.enable_thinkingiçin"qwen-chat-template"kullanın.
Amazon Bedrock keşfi
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üş azami çıktı token sayısı.
--custom-image-input, yalnızca metin meta verilerini zorlamak için --custom-text-input geçin.
Sağlayıcı örnekleri
Cerebras (GLM 4.7 / GPT OSS)
Cerebras (GLM 4.7 / GPT OSS)
Birlikte gelen Cerebras için
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.cerebras/zai-glm-4.7; Z.AI doğrudan kullanımı için zai/glm-4.7 kullanın.Kimi Coding
Kimi Coding
openclaw onboard --auth-choice kimi-code-api-key.Local models (LM Studio)
Local models (LM Studio)
Yerel Modeller bölümüne bakın. Özet: güçlü donanımda LM Studio Responses API üzerinden büyük bir yerel model çalıştırın; yedek kullanım için barındırılan modelleri birleştirilmiş tutun.
MiniMax M2.7 (direct)
MiniMax M2.7 (direct)
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, siz açıkça thinking ayarlamadığınız sürece OpenClaw varsayılan olarak MiniMax düşünmeyi 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)
Moonshot AI (Kimi)
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ında 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
OpenCode
OPENCODE_API_KEY (veya OPENCODE_ZEN_API_KEY) ayarlayın. Zen kataloğu için opencode/... ref’lerini veya Go kataloğu için opencode-go/... ref’lerini kullanın. Kısayol: openclaw onboard --auth-choice opencode-zen veya openclaw onboard --auth-choice opencode-go.Synthetic (Anthropic-compatible)
Synthetic (Anthropic-compatible)
/v1 içermemelidir (Anthropic istemcisi bunu ekler). Kısayol: openclaw onboard --auth-choice synthetic-api-key.Z.AI (GLM-4.7)
Z.AI (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 başvurusu — diğer üst düzey anahtarlar
- Araçlar ve Plugin’ler