Ajan çalışma zamanları

Bir ajan çalışma zamanı, hazırlanmış tek bir model döngüsünün sahibidir: istemi alır, model çıktısını yönlendirir, yerel araç çağrılarını işler ve tamamlanan turu OpenClaw'a döndürür.

Her ikisi de model yapılandırmasının yakınında göründüğü için çalışma zamanları sağlayıcılarla kolayca karıştırılabilir. Bunlar farklı katmanlardır:

Bir çalıştırma çatısı, ajan çalışma zamanını sağlayan uygulamadır (kod terimi). Örneğin, paketle birlikte gelen Codex çalıştırma çatısı codex çalışma zamanını uygular. Genel yapılandırma, sağlayıcı veya model girdilerinde agentRuntime.id kullanır; tüm ajanı kapsayan çalışma zamanı anahtarları eski kalmıştır ve yok sayılır. openclaw doctor --fix, eski tüm ajan çalışma zamanı sabitlemelerini kaldırır ve eski çalışma zamanı model referanslarını, gerektiğinde model kapsamlı çalışma zamanı ilkesiyle birlikte standart sağlayıcı/model referansları olarak yeniden yazar.

İki çalışma zamanı ailesi vardır:

• Gömülü çalıştırma çatıları, OpenClaw'ın hazırlanmış ajan döngüsünün içinde çalışır: yerleşik openclaw çalışma zamanı ile codex ve copilot gibi kayıtlı Plugin çalıştırma çatıları.
• CLI arka uçları, model referansını standart biçimde tutarken yerel bir CLI işlemi çalıştırır. Örneğin, model kapsamlı agentRuntime.id: "claude-cli" ile anthropic/claude-opus-4-8, "Anthropic modelini seç, Claude CLI üzerinden yürüt" anlamına gelir. claude-cli, gömülü bir çalıştırma çatısı kimliği değildir ve AgentHarness seçimine geçirilmemelidir.

copilot çalıştırma çatısı, GitHub Copilot CLI için ayrı ve isteğe bağlı bir harici Plugin çalıştırma çatısıdır; PI, Codex ve GitHub Copilot ajan çalışma zamanı arasındaki kullanıcıya yönelik karar için GitHub Copilot ajan çalışma zamanı bölümüne bakın.

Codex yüzeyleri

Birden fazla yüzey Codex adını paylaşır:

Bu yüzeyler kasıtlı olarak birbirinden bağımsızdır. codex Plugin'ini etkinleştirmek, yerel uygulama sunucusu özelliklerini kullanılabilir hâle getirir; eski Codex yollarının onarımı ve geçerliliğini yitirmiş oturum sabitlemelerinin temizlenmesi openclaw doctor --fix tarafından yönetilir. Bir ajan modeli için openai/* seçmek artık, ajan dışı bir OpenAI API yüzeyi kullanılmadığı sürece, "bunu Codex üzerinden çalıştır" anlamına gelir.

Yaygın ChatGPT/Codex abonelik kurulumu, kimlik doğrulama için Codex OAuth kullanır; ancak model referansını openai/* olarak tutar ve codex çalışma zamanını seçer:

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

Bu, OpenClaw'ın bir OpenAI model referansı seçtiği ve ardından gömülü ajan turunu çalıştırmasını Codex uygulama sunucusu çalışma zamanından istediği anlamına gelir. "API faturalandırmasını kullan" anlamına gelmez; kanalın, model sağlayıcı kataloğunun veya OpenClaw oturum deposunun Codex hâline geldiği anlamına da gelmez.

Paketle birlikte gelen codex Plugin'i etkinleştirildiğinde, doğal dille Codex denetimi için ACP yerine yerel /codex komut yüzeyini (/codex bind, /codex threads, /codex resume, /codex steer, /codex stop) kullanın. Codex için ACP'yi yalnızca kullanıcı ACP/acpx'i açıkça istediğinde veya ACP bağdaştırıcı yolunu test ederken kullanın. Claude Code, Gemini CLI, OpenCode, Cursor ve benzeri harici çalıştırma çatıları ACP kullanmaya devam eder.

Karar ağacı:

1. Codex bağlama/denetim/iş parçacığı/sürdürme/yönlendirme/durdurma -> paketle birlikte gelen codex Plugin'i etkinleştirildiğinde yerel /codex komut yüzeyi.
2. Gömülü çalışma zamanı olarak Codex veya abonelik destekli olağan Codex ajan deneyimi -> openai/<model>.
3. Bir OpenAI modeli için OpenClaw'ın açıkça seçilmesi -> model referansını openai/<model> olarak tutun ve sağlayıcı/model çalışma zamanı ilkesini agentRuntime.id: "openclaw" olarak ayarlayın. Seçili bir openai OAuth profili, OpenClaw'ın Codex kimlik doğrulama aktarımı üzerinden dâhili olarak yönlendirilir.
4. Yapılandırmadaki eski Codex model referansları -> openclaw doctor --fix ile openai/<model> biçimine onarın; doctor, eski model referansının gerektirdiği yerlerde sağlayıcı/model kapsamlı agentRuntime.id: "codex" ekleyerek Codex kimlik doğrulama yolunu korur. Eski codex-cli/* model referansları da aynı openai/<model> Codex uygulama sunucusu yoluna onarılır; OpenClaw artık paketle birlikte gelen bir Codex CLI arka ucunu korumaz.
5. ACP, acpx veya Codex ACP bağdaştırıcısı açıkça istendiğinde -> runtime: "acp" ve agentId: "codex".
6. Claude Code, Gemini CLI, OpenCode, Cursor, Droid veya başka bir harici çalıştırma çatısı -> yerel alt ajan çalışma zamanı değil, ACP/acpx.

OpenAI ailesi ön eklerinin ayrımı için OpenAI ve Model sağlayıcıları bölümlerine bakın. Codex çalışma zamanı destek sözleşmesi için Codex çalıştırma çatısı çalışma zamanı bölümüne bakın.

Çalışma zamanı sahipliği

Farklı çalışma zamanları, döngünün farklı bölümlerine sahip olur:

Tasarım kuralı: OpenClaw yüzeyin sahibiyse normal Plugin kancası davranışı sağlayabilir. Yerel çalışma zamanı yüzeyin sahibiyse OpenClaw'ın çalışma zamanı olaylarına veya yerel kancalara ihtiyacı vardır. Yerel çalışma zamanı standart iş parçacığı durumunun sahibiyse OpenClaw, desteklenmeyen iç yapıları yeniden yazmak yerine bağlamı yansıtır ve yansıtır.

Çalışma zamanı seçimi

OpenClaw, sağlayıcı ve model çözümlemesinden sonra gömülü çalışma zamanını şu sırayla çözümler:

1. Model kapsamlı çalışma zamanı ilkesi önceliklidir. Bu, yapılandırılmış bir sağlayıcı model girdisinde veya agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime içinde bulunur. agents.defaults.models["vllm/*"].agentRuntime gibi bir sağlayıcı joker karakteri, tam model ilkesinden sonra uygulanır; böylece dinamik olarak keşfedilen sağlayıcı modelleri, model başına tam istisnaları geçersiz kılmadan tek bir çalışma zamanını paylaşabilir.
2. Sağlayıcı kapsamlı çalışma zamanı ilkesi: models.providers.<provider>.agentRuntime.
3. auto modu: kayıtlı Plugin çalışma zamanları, desteklenen sağlayıcı/model çiftlerini üstlenebilir.
4. auto modunda hiçbir şey turu üstlenmezse OpenClaw, uyumluluk çalışma zamanı olarak openclawa geri döner. Çalıştırmanın katı olması gerektiğinde açık bir çalışma zamanı kimliği kullanın.

Tüm oturumu ve tüm ajanı kapsayan çalışma zamanı sabitlemeleri yok sayılır: OPENCLAW_AGENT_RUNTIME, oturum agentHarnessId/agentRuntimeOverride durumu, agents.defaults.agentRuntime ve agents.list[].agentRuntime. Geçerliliğini yitirmiş tüm ajan çalışma zamanı yapılandırmasını kaldırmak ve amacın korunabildiği eski çalışma zamanı model referanslarını dönüştürmek için openclaw doctor --fix komutunu çalıştırın.

Açık sağlayıcı/model Plugin çalışma zamanları kapalı biçimde başarısız olur: bir sağlayıcı veya modeldeki agentRuntime.id: "codex", Codex ya da açık bir seçim/çalışma zamanı hatası anlamına gelir; hiçbir zaman sessizce OpenClaw'a geri yönlendirilmez. Eşleşmeyen bir turu OpenClaw'a yalnızca auto yönlendirebilir.

CLI arka uç takma adları, gömülü çalıştırma çatısı kimliklerinden farklıdır. Tercih edilen Claude CLI biçimi:

{  agents: {    defaults: {      model: "anthropic/claude-opus-4-8",      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

claude-cli/claude-opus-4-7 gibi eski referanslar uyumluluk için desteklenmeye devam eder; ancak yeni yapılandırma sağlayıcı/model referansını standart biçimde tutmalı ve yürütme arka ucunu sağlayıcı/model çalışma zamanı ilkesine yerleştirmelidir.

Eski codex-cli/* referansları farklıdır: doctor, bir Codex CLI arka ucunu korumak yerine bunları Codex uygulama sunucusu çalıştırma çatısı üzerinden çalışacak şekilde openai/* biçimine geçirir.

auto modu çoğu sağlayıcı için kasıtlı olarak tutucudur. OpenAI ajan modelleri istisnadır: ayarlanmamış çalışma zamanı ve auto, ikisi de Codex çalıştırma çatısına çözümlenir. Açık OpenClaw çalışma zamanı yapılandırması, openai/* ajan turları için isteğe bağlı bir uyumluluk yolu olmaya devam eder; seçili bir openai OAuth profiliyle eşleştirildiğinde OpenClaw, genel model referansını openai/* olarak tutarken bu yolu Codex kimlik doğrulama aktarımı üzerinden dâhili olarak yönlendirir. Geçerliliğini yitirmiş OpenAI çalışma zamanı oturum sabitlemeleri, çalışma zamanı seçimi tarafından yok sayılır ve openclaw doctor --fix ile temizlenebilir.

openclaw doctor, yapılandırmada eski Codex model referansları kalırken codex Plugin'inin etkin olduğu konusunda uyarırsa bunu eski yol durumu olarak değerlendirin ve Codex çalışma zamanıyla birlikte openai/* biçimine yeniden yazmak için openclaw doctor --fix komutunu çalıştırın.

GitHub Copilot ajan çalışma zamanı

Harici @openclaw/copilot plugini, GitHub Copilot CLI (@github/copilot-sdk) tarafından desteklenen ve isteğe bağlı etkinleştirilen bir copilot çalışma zamanı kaydeder. Standart abonelik sağlayıcısı github-copilot üzerinde hak iddia eder ve auto tarafından asla seçilmez. agentRuntime.id aracılığıyla model veya sağlayıcı bazında etkinleştirin:

{  agents: {    defaults: {      model: "github-copilot/gpt-5.5",      models: {        "github-copilot/gpt-5.5": {          agentRuntime: { id: "copilot" },        },      },    },  },}

Çalıştırma altyapısı; sağlayıcısını, çalışma zamanını, CLI oturum anahtarını ve kimlik doğrulama profili önekini extensions/copilot/doctor-contract-api.ts içinde tanımlar; openclaw doctor bunu otomatik olarak yükler. Yapılandırma, kimlik doğrulama, transkript yansıtma, Compaction, bildirimsel doctor sözleşmesi ve daha kapsamlı PI ile Codex ile Copilot SDK karşılaştırmalı kararı için GitHub Copilot ajan çalışma zamanı bölümüne bakın.

Uyumluluk sözleşmesi

Bir çalışma zamanı OpenClaw değilse belgelerinde hangi OpenClaw yüzeylerini desteklediği belirtilmelidir:

Codex çalışma zamanı destek sözleşmesi Codex çalıştırma altyapısı çalışma zamanı bölümünde belgelenmiştir.

Durum etiketleri

Durum çıktısı hem Execution hem de Runtime etiketlerini gösterebilir. Bunları sağlayıcı adları olarak değil, tanılama bilgileri olarak okuyun:

• openai/gpt-5.6-sol gibi bir model başvurusu, seçilen sağlayıcı/modeldir.
• codex gibi bir çalışma zamanı kimliği, turu yürüten döngüdür.
• Telegram veya Discord gibi bir kanal etiketi, konuşmanın gerçekleştiği yerdir.

Bir çalıştırmada beklenmeyen bir çalışma zamanı görünüyorsa önce seçilen sağlayıcı/model çalışma zamanı politikasını inceleyin. Eski oturum çalışma zamanı sabitlemeleri artık yönlendirmeyi belirlemez.

İlgili

• Codex çalıştırma altyapısı
• Codex çalıştırma altyapısı çalışma zamanı
• GitHub Copilot ajan çalışma zamanı
• OpenAI
• Ajan çalıştırma altyapısı pluginleri
• Ajan döngüsü
• Modeller
• Durum