Bir harness, ajan çalışma zamanını sağlayan uygulamadır (kod
terimi). Örneğin, paketle gelen Codex harness’ı
codex çalışma zamanını uygular.
Herkese açık yapılandırma, sağlayıcı veya model girdilerinde agentRuntime.id kullanır; ajan genelindeki
çalışma zamanı anahtarları eskidir ve yok sayılır. openclaw doctor --fix, eski
ajan genelindeki ç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ına
yeniden yazar.
İki çalışma zamanı ailesi:
- Gömülü harness’lar, OpenClaw’ın hazırlanmış ajan döngüsü içinde çalışır: yerleşik
openclawçalışma zamanı vecodexilecopilotgibi kayıtlı Plugin harness’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"ileanthropic/claude-opus-5, “Anthropic modelini seç, Claude CLI aracılığıyla çalıştır” anlamına gelir.claude-cligömülü bir harness kimliği değildir ve AgentHarness seçimine aktarılmamalıdır.
copilot harness’ı, GitHub Copilot CLI için ayrı ve isteğe bağlı bir harici Plugin harness’ı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 çok yüzey Codex adını paylaşır:
Bu yüzeyler kasıtlı olarak birbirinden bağımsızdır.
codex Plugin’ini
etkinleştirmek yerel app-server özelliklerini kullanılabilir hâle getirir; openclaw doctor --fix,
eski Codex rota onarımının ve geçersiz oturum sabitlemelerinin temizlenmesinin sahibidir. 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 dilde 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ı açıkça ACP/acpx istediğinde veya ACP
bağdaştırıcı yolunu test ederken kullanın. Claude Code, Gemini CLI, OpenCode, Cursor ve benzeri harici
harness’lar ACP kullanmaya devam eder.
Karar ağacı:
- Codex bağlama/denetim/iş parçacığı/sürdürme/yönlendirme/durdurma -> paketle gelen
codexPlugin’i etkinleştirildiğinde yerel/codexkomut yüzeyi. - Gömülü çalışma zamanı olarak Codex veya abonelik destekli olağan Codex ajan deneyimi ->
openai/<model>. - Bir OpenAI modeli için OpenClaw açıkça seçildiğinde -> model referansını
openai/<model>olarak tutun ve sağlayıcı/model çalışma zamanı ilkesiniagentRuntime.id: "openclaw"olarak ayarlayın. Seçili biropenaiOAuth profili, OpenClaw’ın Codex kimlik doğrulama aktarımı üzerinden dahili olarak yönlendirilir. - Yapılandırmadaki eski Codex model referansları ->
openclaw doctor --fixileopenai/<model>biçimine onarın; eski model referansının bunu gerektirdiği yerlerde doctor, sağlayıcı/model kapsamlıagentRuntime.id: "codex"ekleyerek Codex kimlik doğrulama rotasını korur. Eskicodex-cli/*model referansları aynıopenai/<model>Codex app-server rotasına onarılır; OpenClaw artık paketle gelen bir Codex CLI arka ucunu korumaz. - ACP, acpx veya Codex ACP bağdaştırıcısı açıkça istendiğinde ->
runtime: "acp"veagentId: "codex". - Claude Code, Gemini CLI, OpenCode, Cursor, Droid veya başka bir harici harness -> yerel alt ajan çalışma zamanı değil, ACP/acpx.
OpenAI ailesindeki ön ek 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 harness ç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ümlerinin sahibidir:
Tasarım kuralı: Yüzeyin sahibi OpenClaw ise normal Plugin kancası
davranışı sağlayabilir. Yüzeyin sahibi yerel çalışma zamanı ise OpenClaw’ın çalışma zamanı
olaylarına veya yerel kancalara ihtiyacı vardır. Standart iş parçacığı durumunun sahibi
yerel çalışma zamanı ise OpenClaw, desteklenmeyen iç bileşenleri 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:- 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.entries.*.models["provider/model"].agentRuntimeiçinde bulunur.agents.defaults.models["vllm/*"].agentRuntimegibi 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 kesin istisnaları geçersiz kılmadan tek bir çalışma zamanını paylaşabilir. - Sağlayıcı kapsamlı çalışma zamanı ilkesi:
models.providers.<provider>.agentRuntime. automodu: Kayıtlı Plugin çalışma zamanları desteklenen sağlayıcı/model çiftlerini üstlenebilir.automodunda hiçbir şey etkileşimi üstlenmezse OpenClaw, uyumluluk çalışma zamanı olarakopenclawseçeneğine geri döner. Çalıştırmanın katı olması gerektiğinde açık bir çalışma zamanı kimliği kullanın.
OPENCLAW_AGENT_RUNTIME,
oturum agentHarnessId/agentRuntimeOverride durumu, agents.defaults.agentRuntime
ve agents.entries.*.agentRuntime. Geçersiz tüm ajan kapsamındaki çalışma zamanı yapılandırmasını kaldırmak ve
amacın korunabildiği yerlerde eski ç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ı durumda hata verir: 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. Yalnızca auto, eşleşmeyen bir
etkileşimi OpenClaw’a yönlendirebilir.
CLI arka uç diğer adları, gömülü harness kimliklerinden farklıdır. Tercih edilen Claude CLI biçimi:
claude-cli/claude-opus-4-7 gibi eski referanslar uyumluluk için desteklenmeye devam eder,
ancak yeni yapılandırma sağlayıcı/modeli 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, Codex CLI arka ucunu
korumak yerine Codex app-server harness’ı üzerinden çalışmaları için bunları openai/* biçimine taşır.
auto modu çoğu sağlayıcı için kasıtlı olarak tutucudur. OpenAI ajan
modelleri istisnadır: Ayarlanmamış çalışma zamanı ve auto, Codex
harness’ına çözümlenir. Açık OpenClaw çalışma zamanı yapılandırması, openai/* ajan
etkileşimleri için isteğe bağlı bir uyumluluk rotası olmaya devam eder; seçili bir openai OAuth
profiliyle eşleştirildiğinde OpenClaw, herkese açık model referansını openai/* olarak
tutarken bu yolu Codex kimlik doğrulama aktarımı üzerinden dahili olarak yönlendirir. Geçersiz OpenAI
çalışma zamanı oturum sabitlemeleri, çalışma zamanı seçimi tarafından yok sayılır ve
openclaw doctor --fix ile temizlenebilir.
If openclaw doctor, eski Codex model referansları yapılandırmada kalırken codex plugininin etkin olduğu konusunda uyarırsa bunu eski rota durumu olarak değerlendirin ve Codex çalışma zamanı ile 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 github-copilot sağlayıcısını üstlenir ve auto tarafından asla seçilmez. agentRuntime.id aracılığıyla model veya sağlayıcı bazında etkinleştirin:
extensions/copilot/doctor-contract-api.ts içinde üstlenir; openclaw doctor bunu otomatik olarak yükler. Yapılandırma, kimlik doğrulama, transkript yansıtma, Compaction, bildirimsel doctor sözleşmesi ve daha geniş kapsamlı PI, Codex ve Copilot SDK kararı için GitHub Copilot ajan çalışma zamanı bölümüne bakın.
Uyumluluk sözleşmesi
Bir çalışma zamanı OpenClaw olmadığında, belgelerinde hangi OpenClaw yüzeylerini desteklediği belirtilmelidir:
Codex çalışma zamanı destek sözleşmesi
Codex harness çalışma zamanı bölümünde belgelenmiştir.
Durum etiketleri
Durum çıktısı hemExecution hem de Runtime etiketlerini gösterebilir. Bunları sağlayıcı adları olarak değil, tanılama bilgileri olarak değerlendirin:
openai/gpt-5.6-solgibi bir model referansı, seçili sağlayıcı/modeldir.codexgibi 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.