| Katman | Örnekler | Ne anlama gelir |
|---|---|---|
| Sağlayıcı | openai, anthropic, github-copilot | OpenClaw’ın kimlik doğrulamasını, modelleri keşfetmesini ve model referanslarını adlandırmasını belirler. |
| Model | gpt-5.5, claude-opus-4-6 | Ajan turu için seçilen model. |
| Ajan çalışma zamanı | openclaw, codex, copilot, claude-cli | Hazırlanan turu yürüten düşük seviyeli döngü veya arka uç. |
| Kanal | Telegram, Discord, Slack, WhatsApp | İletilerin OpenClaw’a girip çıktığı yer. |
codex çalışma zamanını
uygular. Genel yapılandırma, sağlayıcı veya model girdilerinde agentRuntime.id
kullanır; tüm ajan çalışma zamanı anahtarları legacy’dir ve yok sayılır.
openclaw doctor --fix, eski tüm ajan çalışma zamanı sabitlemelerini kaldırır ve
legacy çalışma zamanı model referanslarını kanonik sağlayıcı/model referanslarına ve gerektiğinde model kapsamlı
çalışma zamanı politikasına yeniden yazar.
İki çalışma zamanı ailesi vardır:
- Gömülü harness’ler, OpenClaw’ın hazırlanmış ajan döngüsünün içinde çalışır. Bugün bu,
yerleşik
openclawçalışma zamanı ilecodexvecopilotgibi kayıtlı Plugin harness’leridir. - CLI arka uçları, model referansını kanonik tutarken yerel bir CLI süreci çalıştırır.
Örneğin, model kapsamlı
agentRuntime.id: "claude-cli"ileanthropic/claude-opus-4-8, “Anthropic modelini seç, Claude CLI üzerinden yürüt” anlamına gelir.claude-cligömülü bir harness kimliği değildir ve AgentHarness seçimine geçirilmemelidir.
copilot harness’i, GitHub Copilot CLI için ayrı, isteğe bağlı harici bir Plugin harness’idir;
PI, Codex ve GitHub Copilot ajan çalışma zamanı arasındaki kullanıcıya dönük karar için
GitHub Copilot ajan çalışma zamanı bölümüne bakın.
Codex yüzeyleri
Çoğu kafa karışıklığı, Codex adını paylaşan birkaç farklı yüzeyden kaynaklanır:| Yüzey | OpenClaw adı/yapılandırması | Ne yapar |
|---|---|---|
| Yerel Codex app-server çalışma zamanı | openai/* model referansları | OpenAI gömülü ajan turlarını Codex app-server üzerinden çalıştırır. Bu, olağan ChatGPT/Codex abonelik kurulumudur. |
| Codex OAuth kimlik doğrulama profilleri | openai OAuth profilleri | Codex app-server harness’inin tükettiği ChatGPT/Codex abonelik kimlik doğrulamasını depolar. |
| Codex ACP adaptörü | runtime: "acp", agentId: "codex" | Codex’i harici ACP/acpx kontrol düzlemi üzerinden çalıştırır. Yalnızca ACP/acpx açıkça istendiğinde kullanın. |
| Yerel Codex sohbet denetimi komut seti | /codex ... | Codex app-server iş parçacıklarını sohbetten bağlar, sürdürür, yönlendirir, durdurur ve inceler. |
| Ajan dışı yüzeyler için OpenAI Platform API rotası | openai/* artı API anahtarı kimlik doğrulaması | Görseller, embeddings, konuşma ve realtime gibi doğrudan OpenAI API’leri için kullanılır. |
codex Plugin’ini etkinleştirmek
yerel app-server özelliklerini kullanılabilir yapar; openclaw doctor --fix legacy
Codex rota onarımını ve eski oturum sabitleme temizliğini yönetir. 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:
codex Plugin’i etkinleştirildiğinde, doğal dilli Codex denetimi
ACP yerine yerel /codex komut yüzeyini (/codex bind, /codex threads,
/codex resume, /codex steer, /codex stop) kullanmalıdır. Codex için ACP’yi
yalnızca kullanıcı açıkça ACP/acpx isterse veya ACP adaptör yolunu test ediyorsa kullanın.
Claude Code, Gemini CLI, OpenCode, Cursor ve benzer harici harness’ler yine ACP kullanır.
Ajanlara dönük karar ağacı şudur:
- Kullanıcı Codex bind/control/thread/resume/steer/stop isterse, birlikte gelen
codexPlugin’i etkinse yerel/codexkomut yüzeyini kullanın. - Kullanıcı gömülü çalışma zamanı olarak Codex isterse veya normal
abonelik destekli Codex ajan deneyimini istiyorsa
openai/<model>kullanın. - Kullanıcı açıkça bir OpenAI modeli için OpenClaw seçerse, model referansını
openai/<model>olarak tutun ve sağlayıcı/model çalışma zamanı politikasınıagentRuntime.id: "openclaw"olarak ayarlayın. Seçili biropenaiOAuth profili, dahili olarak OpenClaw’ın Codex kimlik doğrulama aktarımı üzerinden yönlendirilir. - Legacy yapılandırma hâlâ legacy Codex model referansları içeriyorsa,
openclaw doctor --fixile bunuopenai/<model>olarak onarın; doctor, eski model referansının ima ettiği yerlerde sağlayıcı/model kapsamlıagentRuntime.id: "codex"ekleyerek Codex kimlik doğrulama rotasını korur. Legacycodex-cli/*model referansları aynıopenai/<model>Codex app-server rotasına onarılır; OpenClaw artık birlikte gelen bir Codex CLI arka ucu tutmaz. - Kullanıcı açıkça ACP, acpx veya Codex ACP adaptörü derse,
runtime: "acp"veagentId: "codex"ile ACP kullanın. - İstek Claude Code, Gemini CLI, OpenCode, Cursor, Droid veya başka bir harici harness içinse, yerel alt ajan çalışma zamanı değil ACP/acpx kullanın.
| Kastettiğiniz… | Kullanılacak… |
|---|---|
| Codex app-server sohbet/iş parçacığı denetimi | Birlikte gelen codex Plugin’inden /codex ... |
| Codex app-server gömülü ajan çalışma zamanı | openai/* ajan model referansları |
| OpenAI Codex OAuth | openai OAuth profilleri |
| Claude Code veya başka bir harici harness | ACP/acpx |
Çalışma zamanı sahipliği
Farklı çalışma zamanları döngünün farklı miktarlarına sahiptir.| Yüzey | OpenClaw gömülü | Codex app-server |
|---|---|---|
| Model döngüsü sahibi | OpenClaw gömülü çalıştırıcısı üzerinden OpenClaw | Codex app-server |
| Kanonik iş parçacığı durumu | OpenClaw transkripti | Codex iş parçacığı, artı OpenClaw transkript yansısı |
| OpenClaw dinamik araçları | Yerel OpenClaw araç döngüsü | Codex adaptörü üzerinden köprülenir |
| Yerel kabuk ve dosya araçları | OpenClaw yolu | Desteklendiğinde yerel kancalar üzerinden köprülenen Codex yerel araçları |
| Bağlam motoru | Yerel OpenClaw bağlam derlemesi | OpenClaw, bağlamı Codex turuna derleyerek aktarır |
| Compaction | OpenClaw veya seçili bağlam motoru | OpenClaw bildirimleri ve yansı bakımıyla Codex yerel sıkıştırması |
| Kanal teslimi | OpenClaw | OpenClaw |
- Yüzeye OpenClaw sahipse, OpenClaw normal Plugin kancası davranışı sağlayabilir.
- Yüzeye yerel çalışma zamanı sahipse, OpenClaw çalışma zamanı olaylarına veya yerel kancalara ihtiyaç duyar.
- Kanonik iş parçacığı durumuna yerel çalışma zamanı sahipse, OpenClaw desteklenmeyen iç yapıları yeniden yazmak yerine bağlamı yansıtmalı ve projelendirmelidir.
Çalışma zamanı seçimi
OpenClaw, sağlayıcı ve model çözümlemesinden sonra gömülü bir çalışma zamanı seçer:- Model kapsamlı çalışma zamanı politikası kazanır. Bu, yapılandırılmış sağlayıcı
model girdisinde veya
agents.defaults.models["provider/model"].agentRuntime/agents.list[].models["provider/model"].agentRuntimeiçinde bulunabilir.agents.defaults.models["vllm/*"].agentRuntimegibi bir sağlayıcı wildcard’ı, tam model politikasından sonra uygulanır; böylece dinamik olarak keşfedilen sağlayıcı modeller, tam model başına istisnaları geçersiz kılmadan tek bir çalışma zamanını paylaşabilir. - Sağlayıcı kapsamlı çalışma zamanı politikası sonra
models.providers.<provider>.agentRuntimekonumunda gelir. automodunda, kayıtlı Plugin çalışma zamanları desteklenen sağlayıcı/model çiftlerini üstlenebilir.automodunda hiçbir çalışma zamanı bir turu üstlenmezse, OpenClaw uyumluluk çalışma zamanı olarakopenclawkullanır. Çalıştırmanın katı olması gerekiyorsa açık bir çalışma zamanı kimliği kullanın.
OPENCLAW_AGENT_RUNTIME, oturum agentHarnessId/agentRuntimeOverride durumu,
agents.defaults.agentRuntime ve agents.list[].agentRuntime dahildir.
Eski tüm ajan çalışma zamanı yapılandırmasını kaldırmak ve OpenClaw’ın niyeti koruyabildiği yerlerde
legacy çalışma zamanı model referanslarını dönüştürmek için openclaw doctor --fix çalıştırın.
Açık sağlayıcı/model Plugin çalışma zamanları kapalı hata verir. Örneğin,
bir sağlayıcı veya model üzerinde 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.
CLI arka uç takma adları, gömülü harness kimliklerinden farklıdır. Tercih edilen
Claude CLI biçimi şudur:
claude-cli/claude-opus-4-7 gibi legacy referanslar uyumluluk için desteklenmeye devam eder,
ancak yeni yapılandırma sağlayıcı/modeli kanonik tutmalı ve yürütme arka ucunu
sağlayıcı/model çalışma zamanı politikasına koymalıdır.
Legacy codex-cli/* referansları farklıdır: doctor bunları openai/* olarak taşır;
böylece bir Codex CLI arka ucunu korumak yerine Codex app-server harness’i üzerinden çalışırlar.
auto modu çoğu sağlayıcı için bilinçli olarak muhafazakârdır. OpenAI ajan
modelleri istisnadır: ayarlanmamış çalışma zamanı ve auto ikisi de Codex
harness’ine çözümlenir. Açık OpenClaw çalışma zamanı yapılandırması, openai/* ajan turları için
isteğe bağlı bir uyumluluk rotası olarak kalır; seçili bir openai OAuth profiliyle eşleştirildiğinde,
OpenClaw bu yolu dahili olarak Codex kimlik doğrulama aktarımı üzerinden yönlendirirken
genel model referansını openai/* olarak tutar. Eski 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, eski Codex model referansları yapılandırmada kalırken codex Plugin’inin etkin olduğu konusunda uyarırsa bunu eski rota durumu olarak ele alın. Codex çalışma zamanı ile openai/* olarak yeniden yazmak için openclaw doctor --fix komutunu çalıştırın.
GitHub Copilot ajan çalışma zamanı
Harici@openclaw/copilot Plugin’i, GitHub Copilot CLI (@github/copilot-sdk) tarafından desteklenen isteğe bağlı copilot çalışma zamanını kaydeder. Standart abonelik github-copilot sağlayıcısını üstlenir ve auto tarafından asla seçilmez. agentRuntime.id aracılığıyla model başına veya sağlayıcı başına etkinleştirin:
extensions/copilot/doctor-contract-api.ts içinde üstlenir ve openclaw doctor bunu otomatik olarak yükler. Yapılandırma, kimlik doğrulama, transkript yansıtma, Compaction, bildirime dayalı doctor sözleşmesi ve daha geniş PI ile Codex ile Copilot SDK kararı için bkz. GitHub Copilot ajan çalışma zamanı.
Uyumluluk sözleşmesi
Bir çalışma zamanı OpenClaw olmadığında, hangi OpenClaw yüzeylerini desteklediğini belgelemelidir. Çalışma zamanı dokümanları için bu şekli kullanın:| Soru | Neden önemlidir |
|---|---|
| Model döngüsünün sahibi kimdir? | Yeniden denemelerin, araç devamının ve nihai yanıt kararlarının nerede gerçekleşeceğini belirler. |
| Standart iş parçacığı geçmişinin sahibi kimdir? | OpenClaw’ın geçmişi düzenleyip düzenleyemeyeceğini veya yalnızca yansıtıp yansıtamayacağını belirler. |
| OpenClaw dinamik araçları çalışıyor mu? | Mesajlaşma, oturumlar, cron ve OpenClaw’a ait araçlar buna dayanır. |
| Dinamik araç kancaları çalışıyor mu? | Plugin’ler, OpenClaw’a ait araçların etrafında before_tool_call, after_tool_call ve ara katman bekler. |
| Yerel araç kancaları çalışıyor mu? | Shell, patch ve çalışma zamanına ait araçlar; politika ve gözlem için yerel kanca desteğine ihtiyaç duyar. |
| Bağlam motoru yaşam döngüsü çalışıyor mu? | Bellek ve bağlam Plugin’leri; assemble, ingest, after-turn ve Compaction yaşam döngüsüne bağlıdır. |
| Hangi Compaction verileri açığa çıkarılır? | Bazı Plugin’ler yalnızca bildirimlere ihtiyaç duyarken diğerleri tutulan/bırakılan meta verilere ihtiyaç duyar. |
| Bilerek ne desteklenmiyor? | Kullanıcılar, yerel çalışma zamanının daha fazla duruma sahip olduğu yerlerde OpenClaw eşdeğerliği varsaymamalıdır. |
Durum etiketleri
Durum çıktısı hemExecution hem de Runtime etiketlerini gösterebilir. Bunları sağlayıcı adları olarak değil, tanılama bilgileri olarak okuyun.
openai/gpt-5.5gibi bir model referansı, seçilen sağlayıcıyı/modeli bildirir.codexgibi bir çalışma zamanı kimliği, turu hangi döngünün yürüttüğünü bildirir.- Telegram veya Discord gibi bir kanal etiketi, konuşmanın nerede gerçekleştiğini bildirir.