OpenClaw birden çok ajan ve model: yönlendirme, yalıtım ve maliyet

OpenClaw'da çoklu ajanlar ve birden çok model, tek bir yapılandırma dosyasının iki farklı katmanıdır: birkaç ajan agents.entries altında anahtarlanmış girdiler olarak yer alır; her biri kendi çalışma alanına, durum dizinine ve oturum deposuna sahipken, birkaç model bu girdilerin içindeki ajan başına model değerleridir. Bunların yanında iki katman daha bulunur — bindings, hangi ajanın yanıt vereceğine karar verir; bir geri dönüş zinciri ise model başarısız olduğunda tek bir ajanın ne yapacağını belirler. Yanlış katmanı düzenlemek, bir değişikliğin hiçbir şey yapmıyor gibi görünmesinin en yaygın nedenidir.

Daha fazla ajan çalıştırmanın yazılım açısından hiçbir maliyeti yoktur. OpenClaw'ın dokümantasyona genel bakış sayfası, yazılımın "bağımsız bir 501(c)(3) kuruluşu olan OpenClaw Foundation" tarafından açık bir şekilde geliştirildiğini belirtir ve "Ücretli plan yok, kapatabileceğiniz bir sürüm kontrolü dışında varsayılan olarak telemetri yok, hiçbir laboratuvarın mülkiyetinde değil" der. openclaw.ai ise "Abonelik yok. Barındırılan hizmet planı yok. Token yok." diye ekler. openclaw npm paketi MIT lisanslıdır; latest sürümü 2026.9.5, extended-stable kanalındaki sürüm 2026.7.35 ve engines.node değeri >=24.16.0 <25 || >=26.1.0 olarak belirtilmiştir (npm kayıt deposu, 21 Eylül 2026 tarihinde kontrol edildi). İkinci bir ajanın faturanıza eklediği maliyet, token maliyetidir.

OpenClaw çoklu ajanları: dört katman ve yanlış katmanı düzenlediğinizde görülen belirti

Dördü de 21 Eylül 2026'da OpenClaw'ın kendi belgelerinden okundu: entries and multi-agent, agent bindings ve model failover. Eski eğitimlerdeki iki yapı güncelliğini yitirmiştir: agents.list dizisi, Doctor'ın taşıdığı eski biçimdir; bir girişteki default: true işareti ise kullanımdan kaldırılmıştır — entries sayfası açıkça "default kullanımdan kaldırıldı" der ve çok ajanlı işlemler için bir binding veya açık bir hedef gerektiğini belirtir. OpenClaw daha önce iki farklı adla da çalıştığından, bulduğunuz Moltbot veya Clawdbot dönemi yapılandırmaları bu şemadan öncesine aittir.

OpenClaw çoklu ajan kurulumu: iki ajanlı, iki modelli minimal yapılandırma

Bu parça, zaten çalışan bir models.providers bloğunuz olduğunu varsayar — OpenClaw için en iyi API, api: "anthropic-messages" ve Anthropic base URL dahil olmak üzere Kunavo yapılandırmasını içerir. Aşağıda yalnızca ajan ve yönlendirme katmanı ele alınır.

{
  "agents": {
    "defaults": {
      "modelSelectionScope": "session",
      "model": {
        "primary": "kunavo/claude-haiku-4-5",
        "fallbacks": [
          "kunavo/claude-sonnet-5"
        ]
      }
    },
    "entries": {
      "ops": {
        "name": "Ops",
        "workspace": "~/.openclaw/workspace-ops",
        "agentDir": "~/.openclaw/agents/ops/agent",
        "model": "kunavo/claude-haiku-4-5",
        "modelPolicy": {
          "allow": [
            "kunavo/claude-haiku-4-5"
          ]
        }
      },
      "build": {
        "name": "Build",
        "workspace": "~/.openclaw/workspace-build",
        "agentDir": "~/.openclaw/agents/build/agent",
        "model": {
          "primary": "kunavo/claude-opus-5",
          "fallbacks": [
            "kunavo/claude-sonnet-5"
          ]
        },
        "utilityModel": "kunavo/claude-haiku-4-5"
      }
    }
  },
  "bindings": [
    {
      "agentId": "build",
      "match": {
        "channel": "discord",
        "accountId": "build"
      }
    },
    {
      "agentId": "ops",
      "match": {
        "channel": "discord",
        "accountId": "*"
      }
    }
  ]
}

Bu blokta dört şey kritik öneme sahiptir. Her ajanın kendi agentDir değeri vardır; çünkü çoklu ajan sayfası "Ajanlar arasında hiçbir zaman agentDir değerini yeniden kullanmayın — bu, kimlik doğrulama/oturum durumu çakışmalarına neden olur" uyarısını yapar. ops ajanı, model değerinin string biçimini kullanır; entries sayfası bunu "model geri dönüşü olmayan, ajan başına katı bir birincil" olarak tanımlar — böylece bir hata, rutin işi sessizce daha pahalı bir katmana taşımaz ve görünür hale gelir. build ajanı, açık bir fallbacks listesi içeren nesne biçimini kullanır; bu, bir ajanı seçeneğe dahil etmenin yoludur. Failover sayfası ayrıca bir ajanın yalnızca model: { fallbacks: [...] } ayarlayarak paylaşılan birincil modeli devralmaya devam edebileceğini belirtir. Dar binding, joker karakterin üzerinde yer alır; çünkü tek bir eşleştirme katmanında "ilk eşleşen bindings girdisi kazanır."

Çalışma alanı varsayılanları, varsayılan ajan ile diğer ajanlar arasında farklıdır ve açıkça ayarlanmaya değerdir: varsayılan ajanın çalışma alanı <stateDir>/workspace, diğer ajanlarınki ise varsayılan olarak <stateDir>/workspace-<agentId> olur. OpenClaw'ın yerleşik motoru "ajanınızın çalışma alanına düz Markdown dosyaları yazarak bir şeyleri hatırladığı" için bellek çalışma alanını izler; dolayısıyla çalışma alanlarını yalıtmak belleği de yalıtır. Oturum izin modları yine ayrı bir eksendir: read-only, guarded, workspace ve full; burada "full, operator.admin gerektirir. Diğer modlar operator.write gerektirir" (permission modes, 21 Eylül 2026). İzinleri geniş bir ajandaki ucuz model, hâlâ izinleri geniş bir ajandır.

Ayrı ajanların ayırdığı şeyler — ve ayırmadıkları

Rolleri bölerken dikkat edilmesi gereken sınır budur. Ayrı girdiler size ayrı dosyalar, bellek, geçmiş, araç politikası ve saklanan kimlik doğrulama profilleri sağlar. Ancak bunlar, ortamla yapılandırılmış özel bir sağlayıcı için her ajana kendi API anahtarını tek başına sağlamaz — belgelenen ajan başına şemada baseUrl, apiKey veya providers alanlarının hiçbiri yoktur. Belgelerde yer almaması, kodun bunu yasakladığının kanıtı değildir; bu nedenle bunu belgelenmemiş olarak okuyun. Kiracı başına kesin anahtar ayrımı gerekiyorsa ayrı Gateways çalıştırın. Kimlikle ilgili benzer bir sınır da vardır: OpenClaw'ın WhatsApp DM-split örneği, "Yanıtlar hâlâ aynı WhatsApp numarasından gelir — ajan başına gönderen kimliği yoktur" ve "Doğrudan sohbetler varsayılan olarak ajanın ana oturum anahtarında birleşir; gerçek yalıtım için kişi başına bir ajan gerekir" der. Bu ifade WhatsApp için geçerlidir; genellemeden önce kendi kanalınızın sayfasını kontrol edin.

Rolleri bölerken dikkat edilmesi gereken bir yetenek sınırı daha var: Kunavo metinden konuşmaya, konuşmadan metne veya embedding modeli sunmaz; bu nedenle sesli çıktı ya da vektör dizini gerektiren bir ajanın bu adım için harici bir sağlayıcı çağırması gerekir.

OpenClaw çoklu modelleri: katı, geri dönüş, politika ve yardımcı hat

Ajan başına model seçimi, bilinçli şekilde ayarlanmaya değer dört denetime sahiptir. Bir string olarak model katıdır. { primary, fallbacks: [...] }, ilgili ajanı failover'a dahil eder. modelPolicy.allow, "o ajan için varsayılan politikanın yerine geçen" bir izin listesidir — takma adları, tam referansları ve sondaki joker karakterleri kabul eder — bu da rutin bir ajanın pahalı bir modele ulaşmasını tamamen engellemenizi sağlar. utilityModel ise "oluşturulan oturum ve ileti dizisi başlıkları gibi kısa dahili görevler" için kullanılan, genellikle daha ucuz ve ajan başına geçersiz kılma desteğine sahip ayrı bir modeldir.

Belgelenen tetikleyici listesi özeldir. OpenClaw "kimlik doğrulama hataları, hız sınırları ve bekleme süresinin tükenmesi, aşırı yüklenmiş/meşgul sağlayıcı hataları, zaman aşımı biçimli failover hataları, faturalandırma devre dışı bırakmaları, model_not_found" ve adaylar kaldığı sürece tanınmayan diğer hatalarda ilerler; ancak sıkıştırma ve yeniden deneme mantığı içinde kalan bağlam taşması hatalarında ve "zaman aşımı/failover biçiminde olmayan açık iptallerde" ilerlemez. Grup ve kanal dışındaki konuşmalarda bu görünürdür: bu yüzeyler Model Fallback: <fallback> (selected <primary>; <reason>) biçiminde bir durum bildirimi ve eşleşen bir temizlendi bildirimi yayımlar; grup ve kanal konuşmaları ise "aynı geri dönüş durumunu korurken görünür bildirimleri gizler." Bu nedenle paylaşılan bir odada böyle bir bildirim görmeye güvenmeyin. Açık bir oturum seçimi — /model, model seçici, session_status(model=...) veya sessions.patch — katıdır: bu model yanıt üretmeden önce başarısız olursa OpenClaw yapılandırılmış bir geri dönüşten yanıt vermek yerine hatayı bildirir. Bir cron işinin --model değeri bunlardan biri değildir; belgeler bunu, iş payload.fallbacks: [] ayarlamadığı sürece yapılandırılmış geri dönüşleri kullanmaya devam eden iş birincil modeli olarak adlandırır.

Niyetinizin korunup korunmayacağına iki mekanizma daha karar verir. İstek parametreleri agents.defaults.params değerinden agents.entries.*.params değerine kadar dört katmanda birleştirilir ve sonraki katmanlar anahtar bazında öncekinin üzerine yazar. Paralellik için hesaplanan bir üst sınır vardır: agents.defaults.maxConcurrent oturumlar genelinde varsayılan olarak max(8, available CPU parallelism * 4) değerindedir; her oturum ise serileştirilmiş kalır — aynı ajana gönderilen iki ileti aynı anda çalışmaz. Hangi rol için hangi modelin uygun olduğunu seçmek üzere Opus vs Sonnet vs Haiku, yetenek tarafını ele alır.

Maliyeti ajana göre değil, rotaya göre paylaştırma

Belgelenmiş hiçbir komut harcamayı ajan başına raporlamadığından, maliyeti rota bazında paylaştırın. Aşağıdaki hesaplama ölçülmüş bir fatura veya üst sınır değil, açıklama amaçlıdır. 30 günlük bir ayı, belgelenen 30m heartbeat varsayılanını (1.440 çalıştırma), heartbeat başına 300 çıktı token'ını, önbellek isabeti olmadığını ve 8M girdi ile 500K çıktı token'ından oluşan ana konuşma hattını varsayar. ~100K ve ~2–5K çalıştırma başına bağlam rakamları, OpenClaw'ın isolatedSession değerinin neyi kaldırdığını gösteren kendi örneğidir; burada ölçülmüş değildir; 3.000 orta noktadır. Oranlar, milyon token başına güncel Kunavo kataloğu fiyatlarıdır.

Claude Haiku 4.5 güncel katalogda milyon girdi / çıktı token'ı başına $0,70 / $3,50 değerlerini listeler; Claude Opus 5 ise $3,50 / $17,50 değerlerini listeler. Önemli sonuç şudur: bu varsayımlar altında zamanlanmış hat baskındır. Güçlü modelde paylaşılan oturum heartbeat'i ayda $511,56 tutarken, ucuz modelde isolatedSession: true ile aynı sıklık $4,54 tutar. OpenClaw bunu kendisi de şöyle ifade eder: "Heartbeat'ler tam ajan turları çalıştırır. Daha kısa aralıklar daha fazla token tüketir"; ayrıca isolatedSession, lightContext, daha ucuz bir model ve target: "none" değerlerini kontrol kolları olarak belirtir.

Ucuz heartbeat hilesinin belgelenmiş bir arıza modu vardır; model değişikliğinin tek başına kullanılmasına kıyasla isolatedSession değerinin daha iyi bir kaldıraç olmasının nedeni budur. Heartbeat'ler "çalışma tamamlandıktan sonra paylaşılan oturumun mevcut çalışma zamanı modelini korur"; bu nedenle oturumu daha küçük bir modele geçiren bir heartbeat, sonraki ana oturum turunda o modeli yerinde bırakabilir ve bu tur da bağlam taşması bildirebilir — OpenClaw'ın kurtarma mesajı buna heartbeat model bleed adını verir. Belgelerdeki örnek, 32k pencereli yerel bir modeldir; dolayısıyla riskin boyutu, heartbeat modelinin bağlam penceresinin paylaşılan oturumun gereksiniminden ne kadar küçük olduğuna bağlıdır. Zamanlama notu: belgelenen varsayılan aralık 30m değeridir; yalnızca çözümlenen kimlik doğrulama modu Anthropic OAuth/token olduğunda 1h değerine çıkar. Bu nedenle heartbeat.every değerini kendiniz ayarlamadığınız sürece düz bir API anahtarı rotası 30m olarak kalır. Bütçe hazırlamadan önce kendi değerinizi kontrol edin.

Dolar rakamlarıyla ilgili iki uyarı var. Kunavo kataloğundaki tutar bir üst sınır değil, faturalandırma tabanıdır: upstream kendi ücretini bildirdiğinde fatura, katalog maliyeti ile upstream maliyetinin geçerli markup ile çarpımından büyük olanıdır. Model başına cost nesnesi olmadan tanımlanan özel bir sağlayıcı, OpenClaw'ın kendi gösterimini işe yaramaz hâle getirir; OpenClaw cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } varsayımını kullanır ve tedarikçi normal şekilde ücret alırken $0 gösterir. Eklediğiniz her modelde cost, contextWindow ve maxTokens değerlerini tanımlayın ve sağlayıcı defteriyle mutabakat yapın. Kunavo'da minimum yükleme, $10 ön ödemeli kredidir — bu bir finansman minimumudur; görev ücreti veya abonelik değildir. faturalandırma ayrıntılarına ve AI maliyet optimizasyonuna bakın.

Çok ajanlı bir Gateway için hangi satın alma rotası uygun?

Önbelleklemenin mali açıdan büyük önem taşıması nedeniyle protokol biçimleri hakkında bir not. İlgili kılavuzdaki Kunavo bloğu api: "anthropic-messages" değerini tanımlar; OpenClaw bunu doğrudan olmayan bir Anthropic uç noktası olarak değerlendirir. Bunun iki belgelenmiş sonucu vardır. Örtük Anthropic beta başlıkları bu tür uç noktalarda bastırılır; bu nedenle aralıklı düşünme gibi özellikler otomatik olarak etkinleşmez, açıkça belirtilen bir headers["anthropic-beta"] aracılığıyla etkinleştirilir. Önbellekleme de ayrıca istenmelidir: OpenClaw cacheRetention: "short" değerini yalnızca doğrudan anthropic ve anthropic-vertex sağlayıcıları için başlatır; "anthropic-messages ile uyumlu özel uç noktalar" ise "cacheRetention açıkça ayarlandığında" desteklenir — bu nedenle varsayılan bir değer olduğunu varsaymak yerine params.cacheRetention değerini kendiniz ayarlayın (istem önbellekleme, 21 Eylül 2026). Diğer protokol biçimi için ayrı bir kural geçerlidir: sağlayıcının kendi uç noktası olmayan bir uç noktaya giden openai-completions rotası "hiçbir istem önbellekleme ipucu" göndermez. Tekrarlanan bağlamı önbellek isabetleri olarak bütçelemeden önce kendi rotanızdaki bildirilen önbellek kullanımını doğrulayın. İstem önbellekleme fiyatlandırma tarafını ele alır.

Değişikliğin amaçladığınız yere uygulandığını doğrulayın

openclaw config validate
openclaw gateway restart
openclaw agents list --bindings
openclaw models status --agent ops --json --check
openclaw models list --agent build

Yapılandırma doğrulaması yapıyı kontrol eder ve gateway yeniden başlatma işlemi yapılandırmayı yeniden yükler; ancak hiçbiri ücretlendirilen bir isteğin başarılı olduğunu kanıtlamaz. openclaw agents list --bindings, gerçekten yüklenen yönlendirmeyi gösterir — kavram sayfalarında görünen ancak CLI komut tablosunda yer almayan --tree yerine bunu tercih edin. openclaw models status --agent <id>, o ajanın yapılandırılmış varsayılanını açıklar; models list --agent <id> ise envanterini gösterir. models set, bilinmeyen bir sağlayıcıda sıfırdan farklı bir çıkış koduyla sonlanıyorsa sorun model katmanındadır: sağlayıcı yüklü bir eklenti olmalı veya models.providers altında tanımlanmalıdır. İletiler hiçbir ajana ulaşmıyorsa sorun yönlendirme katmanındadır. Birkaç ajan bir kanalı paylaştığında yinelenen çalıştırmalar görünüyorsa OpenClaw, bot loop protection anahtarlarını koruma mekanizması olarak belgeler — belgeler önlemeyi açıklar, kök nedeni değil; varsayımda bulunmadan önce teşhis edin.

Ardından ajan başına sınırlandırılmış bir görev çalıştırın ve sağlayıcı hesabınızın bu görev için kaydettiği ücreti okuyun. Kunavo, OpenClaw'ı tek veya çok ajanlı olarak çalışma zamanında test etmemiştir: yukarıdaki her şey OpenClaw'ın yayımlanmış belgelerinden okunmuştur ve yayımlanmış bir yapılandırma uyumluluk testi değildir. Deneme sırasında çalışan bir rotayı kullanılabilir durumda tutun. sağlayıcı yapılandırmasıyla başlayın, toplam işletim faturasını OpenClaw fiyatlandırmasıyla karşılaştırın ve bir anahtara bakiye yüklemeye hazır olduğunuzda Kunavo hesabı oluşturun.

Sık sorulan sorular

OpenClaw belgeleri, CLI referansı ve npm registry girdisi, paket sürümü 2026.9.5 ile birlikte 21 Eylül 2026'da kontrol edilmiştir; burada hiçbir Gateway, ajan, binding veya ücretli istek çalıştırılmamıştır. Kunavo token oranları güncel katalogdan okunmuştur ve bu sayfadaki her dolar rakamı ölçülmüş bir fatura değil, açıklama amaçlı token hesabıdır.