ACP aracıları

• plugins.allow ayarlanmışsa bu, kısıtlayıcı bir plugin envanteridir ve acpx öğesini içermelidir; aksi takdirde yüklü ACP arka ucu kasıtlı olarak engellenir (/acp doctor eksik izin listesi girdisini bildirir).
• Codex ACP bağdaştırıcısı acpx plugin'iyle birlikte gelir ve mümkün olduğunda yerel olarak başlatılır.
• Codex ACP, yalıtılmış bir CODEX_HOME ile çalışır. OpenClaw, güvenilen proje güven girdilerini ve güvenli model/sağlayıcı yönlendirme yapılandırmasını (model, model_provider, model_reasoning_effort, sandbox_mode ve güvenli model_providers.<name> alanları) ana makinedeki Codex yapılandırmasından kopyalar; kimlik doğrulama, bildirimler ve kancalar yalnızca ana makine yapılandırmasında kalır.
• Diğer hedef yürütme ortamı bağdaştırıcıları ilk kullanımda npx ile talep üzerine getirilebilir.
• Bu yürütme ortamı için sağlayıcı kimlik doğrulaması ana makinede önceden mevcut olmalıdır.
• Ana makinede npm veya ağ erişimi yoksa önbellekler önceden doldurulana ya da bağdaştırıcı başka bir yöntemle yüklenene kadar ilk çalıştırmadaki bağdaştırıcı getirme işlemleri başarısız olur.

ACP gerçek bir harici yürütme ortamı süreci başlatır. OpenClaw yönlendirmenin, arka plan görevi durumunun, teslimatın, bağlamaların ve politikanın sahibidir; yürütme ortamı ise sağlayıcı oturum açma işleminin, model kataloğunun, dosya sistemi davranışının ve yerel araçların sahibidir.

OpenClaw'ı sorumlu tutmadan önce şunları doğrulayın:

• /acp doctor etkin ve sağlıklı bir arka uç bildiriyor.
• Bu izin listesi ayarlandığında hedef kimliğine acp.allowedAgents tarafından izin veriliyor.
• Yürütme ortamı komutu Gateway ana makinesinde başlatılabiliyor.
• Bu yürütme ortamı için sağlayıcı kimlik doğrulaması mevcut (claude, codex, gemini, opencode, droid vb.).
• Seçilen model bu yürütme ortamında mevcut; model kimlikleri yürütme ortamları arasında taşınabilir değildir.
• İstenen cwd mevcut ve erişilebilir; aksi takdirde cwd öğesini belirtmeyin ve arka ucun varsayılanını kullanmasına izin verin.
• İzin modu çalışmayla eşleşiyor. Etkileşimsiz oturumlar yerel izin istemlerine tıklayamaz; bu nedenle yoğun yazma/çalıştırma gerektiren kodlama çalışmaları genellikle kullanıcı etkileşimi olmadan ilerleyebilen bir ACPX izin profiline ihtiyaç duyar.

• Başlatma, bir ACP çalışma zamanı oturumu oluşturur veya sürdürür, ACP meta verilerini OpenClaw oturum deposuna kaydeder ve çalıştırma üst öğe tarafından yönetiliyorsa bir arka plan görevi oluşturabilir.
• Üst öğe tarafından yönetilen ACP oturumları, çalışma zamanı oturumu kalıcı olsa bile arka plan işi olarak değerlendirilir; tamamlanma ve yüzeyler arası teslimat, normal bir kullanıcıya yönelik sohbet oturumu gibi davranmak yerine üst görev bildiricisi üzerinden gerçekleştirilir.
• Görev bakımı, sonlandırılmış veya sahipsiz, üst öğe tarafından yönetilen tek seferlik ACP oturumlarını kapatır. Etkin bir konuşma bağlaması bulunduğu sürece kalıcı ACP oturumları korunur; etkin bağlaması olmayan eski kalıcı oturumlar, sahip görev tamamlandıktan veya görev kaydı silindikten sonra sessizce sürdürülememeleri için kapatılır.
• Bağlanmış takip mesajları, bağlama kapatılana, odaktan çıkarılana, sıfırlanana veya süresi dolana kadar doğrudan ACP oturumuna gider.
• Gateway komutları yerel kalır. /acp ..., /status ve /unfocus, bağlı bir ACP yürütücüsüne hiçbir zaman normal istem metni olarak gönderilmez.
• cancel, arka uç iptali desteklediğinde etkin turu durdurur; bağlamayı veya oturum meta verilerini silmez.
• close, OpenClaw açısından ACP oturumunu sonlandırır ve bağlamayı kaldırır. Bir yürütücü, sürdürmeyi destekliyorsa kendi yukarı akış geçmişini tutmaya devam edebilir.
• acpx plugin'i, close sonrasında OpenClaw tarafından yönetilen sarmalayıcı ve bağdaştırıcı işlem ağaçlarını temizler ve Gateway başlatılırken sahipsiz kalmış OpenClaw tarafından yönetilen ACPX süreçlerini sonlandırır.
• Boştaki çalışma zamanı işçileri, yerleşik boşta kalma süresinden sonra temizlenebilir; depolanan oturum meta verileri /acp sessions için kullanılabilir durumda kalır.

Etkinleştirildiğinde yerel Codex plugin'ine yönlendirilmesi gereken doğal dil tetikleyicileri:

• "Bu Discord kanalını Codex'e bağla."
• "Bu sohbeti <id> Codex iş parçacığına bağla."
• "Codex iş parçacıklarını göster, ardından bunu bağla."

Yerel Codex konuşma bağlaması, varsayılan sohbet denetimi yoludur. OpenClaw dinamik araçları OpenClaw üzerinden yürütülmeye devam ederken kabuk/apply-patch gibi Codex'e özgü araçlar Codex içinde yürütülür. Codex'e özgü araç olayları için OpenClaw, plugin kancalarının before_tool_call öğesini engelleyebilmesi, after_tool_call öğesini gözlemleyebilmesi ve Codex PermissionRequest olaylarını OpenClaw onayları üzerinden yönlendirebilmesi amacıyla her tur için yerel bir kanca aktarımı ekler. Codex Stop kancaları, plugin'lerin Codex yanıtını tamamlamadan önce bir model geçişi daha isteyebildiği OpenClaw before_agent_finalize öğesine aktarılır. Aktarım bilinçli olarak ihtiyatlı kalır: Codex'e özgü araç bağımsız değişkenlerini değiştirmez veya Codex iş parçacığı kayıtlarını yeniden yazmaz. ACP çalışma zamanı/oturum modelini istediğinizde yalnızca açık ACP kullanın. Gömülü Codex destek sınırı Codex yürütücüsü v1 destek sözleşmesinde belgelenmiştir.

• eski Codex model başvuruları - doctor tarafından onarılan eski Codex OAuth/abonelik model rotası.
• openai/* - OpenAI ajan turları için yerel Codex app-server gömülü çalışma zamanı.
• /codex ... - yerel Codex konuşma denetimi.
• /acp ... veya runtime: "acp" - açık ACP/acpx denetimi.

ACP çalışma zamanına yönlendirilmesi gereken tetikleyiciler:

• "Bunu tek seferlik bir Claude Code ACP oturumu olarak çalıştır ve sonucu özetle."
• "Bu görev için bir iş parçacığında Gemini CLI kullan, ardından takipleri aynı iş parçacığında sürdür."
• "Codex'i ACP üzerinden bir arka plan iş parçacığında çalıştır."

OpenClaw, runtime: "acp" öğesini seçer, agentId yürütücüsünü çözümler, desteklendiğinde mevcut konuşmaya veya iş parçacığına bağlanır ve kapatılana/süresi dolana kadar takipleri bu oturuma yönlendirir. Codex bu yolu yalnızca ACP/acpx açıkça belirtildiğinde veya istenen işlem için yerel Codex plugin'i kullanılamadığında izler.

sessions_spawn için runtime: "acp", yalnızca ACP etkinleştirildiğinde, istekte bulunan korumalı alanda olmadığında ve bir ACP çalışma zamanı arka ucu yüklendiğinde sunulur. acp.dispatch.enabled=false, otomatik ACP iş parçacığı gönderimini duraklatır ancak açık sessions_spawn({ runtime: "acp" }) çağrılarını gizlemez veya engellemez. codex, claude, droid, gemini veya opencode gibi ACP yürütücü kimliklerini hedefler. Bu girdi açıkça agents.entries.*.runtime.type="acp" ile yapılandırılmadığı sürece agents_list içinden normal bir OpenClaw yapılandırma ajanı kimliği geçirmeyin; bunun yerine varsayılan alt ajan çalışma zamanını kullanın. Bir OpenClaw ajanı runtime.type="acp" ile yapılandırıldığında OpenClaw, temel yürütücü kimliği olarak runtime.acp.agent kullanır.

• --bind here ve --thread ... birbirini dışlar.
• --bind here yalnızca mevcut konuşma bağlama desteğini bildiren kanallarda çalışır; aksi durumda OpenClaw açık bir desteklenmiyor mesajı döndürür. Bağlamalar, gateway yeniden başlatmaları boyunca kalıcıdır.
• Discord'da spawnSessions, --bind here için değil, --thread auto|here için alt iş parçacığı oluşturulmasını denetler.
• --cwd olmadan farklı bir ACP ajanı başlatırsanız OpenClaw varsayılan olarak hedef ajanın çalışma alanını devralır. Eksik devralınan yollar (ENOENT/ENOTDIR) arka uç varsayılanına geri döner; diğer erişim hataları (ör. EACCES) başlatma hataları olarak gösterilir.
• Gateway yönetim komutları bağlı konuşmalarda yerel kalır; normal takip metni bağlı ACP oturumuna yönlendirilse bile /acp ... komutları OpenClaw tarafından işlenir; komut işleme söz konusu yüzey için etkinleştirildiğinde /status ve /unfocus da her zaman yerel kalır.

Bir kanal bağdaştırıcısı için iş parçacığı bağlamaları etkinleştirildiğinde:

• OpenClaw, bir iş parçacığını hedef ACP oturumuna bağlar.
• Bu iş parçacığındaki takip mesajları bağlı ACP oturumuna yönlendirilir.
• ACP çıktısı aynı iş parçacığına geri teslim edilir.
• Odaktan çıkarma/kapatma/arşivleme/boşta kalma zaman aşımı veya azami yaş süresinin dolması bağlamayı kaldırır.
• /acp close, /acp cancel, /acp status, /status ve /unfocus, ACP yürütücüsüne gönderilen istemler değil, Gateway komutlarıdır.

İş parçacığına bağlı ACP için gerekli özellik bayrakları:

• acp.enabled=true
• acp.dispatch.enabled varsayılan olarak açıktır (otomatik ACP iş parçacığı gönderimini duraklatmak için false ayarlayın; açık sessions_spawn({ runtime: "acp" }) çağrıları çalışmaya devam eder).
• Kanal bağdaştırıcısı iş parçacığı oturum başlatmaları etkin (varsayılan: true):
  • Discord/Telegram: session.threadBindings.spawnSessions=true

İş parçacığı bağlama desteği bağdaştırıcıya özeldir. Etkin kanal bağdaştırıcısı iş parçacığı bağlamalarını desteklemiyorsa OpenClaw açık bir desteklenmiyor/kullanılamıyor mesajı döndürür.

• Oturum/iş parçacığı bağlama yeteneği sunan tüm kanal bağdaştırıcıları.
• Mevcut yerleşik destek: Discord iş parçacıkları/kanalları, Telegram konuları (gruplarda/süper gruplarda forum konuları ve DM konuları).
• Plugin kanalları aynı bağlama arayüzü üzerinden destek ekleyebilir.

Etkileşimli oturumlar, görünür bir sohbet yüzeyinde konuşmayı sürdürmek için tasarlanmıştır:

• /acp spawn ... --bind here, etkin konuşmayı ACP oturumuna bağlar.
• /acp spawn ... --thread ..., bir kanal iş parçacığını/konusunu ACP oturumuna bağlar.
• Kalıcı yapılandırılmış bindings[].type="acp", eşleşen konuşmaları aynı ACP oturumuna yönlendirir.

Bağlı konuşmadaki takip mesajları doğrudan ACP oturumuna yönlendirilir ve ACP çıktısı aynı kanala/iş parçacığına/konuya geri teslim edilir.

OpenClaw'ın çalıştırma sistemine gönderdikleri:

• Normal bağlı takipler, istem metni olarak ve yalnızca harness/backend bunları desteklediğinde eklerle birlikte gönderilir.
• /acp yönetim komutları ve yerel Gateway komutları, ACP gönderiminden önce yakalanır.
• Çalışma zamanı tarafından oluşturulan tamamlanma olayları hedef başına somutlaştırılır. OpenClaw ajanları, OpenClaw'ın dahili çalışma zamanı bağlam zarfını alır; harici ACP harness'leri ise alt öğenin sonucu ve talimatı içeren düz bir istem alır. Ham <<&lt;BEGIN_OPENCLAW_INTERNAL_CONTEXT&gt;>> zarfı hiçbir zaman harici harness'lere gönderilmemeli veya ACP kullanıcı transkript metni olarak kalıcılaştırılmamalıdır.
• ACP transkript girdileri, kullanıcıya görünür tetikleme metnini veya düz tamamlanma istemini kullanır. Dahili olay meta verileri mümkün olduğunda OpenClaw içinde yapılandırılmış olarak kalır ve kullanıcı tarafından yazılmış sohbet içeriği olarak değerlendirilmez.

Başka bir ajan çalıştırması tarafından oluşturulan tek seferlik ACP oturumları, alt ajanlara benzer arka plan alt öğeleridir:

• Üst öğe, sessions_spawn({ runtime: "acp", mode: "run" }) ile iş yapılmasını ister.
• Alt öğe kendi ACP harness oturumunda çalışır.
• Alt öğe dönüşleri, yerel alt ajan oluşturmalarında kullanılan aynı arka plan şeridinde çalışır; böylece yavaş bir ACP harness'i, ilgisiz ana oturum çalışmalarını engellemez.
• Tamamlanma, görev tamamlama duyuru yolu üzerinden geri bildirilir. OpenClaw, harici bir harness'e göndermeden önce dahili tamamlanma meta verilerini düz bir ACP istemine dönüştürür; böylece harness'ler yalnızca OpenClaw'a özgü çalışma zamanı bağlam işaretçilerini görmez.
• Kullanıcıya yönelik bir yanıt yararlı olduğunda üst öğe, alt öğenin sonucunu normal asistan üslubuyla yeniden yazar.

Bu yolu, üst öğe ile alt öğe arasında eşler arası sohbet olarak değerlendirmeyin. Alt öğenin üst öğeye geri dönen bir tamamlanma kanalı zaten vardır.

sessions_send, oluşturma işleminden sonra başka bir oturumu hedefleyebilir. Normal eş oturumları için OpenClaw, iletiyi ekledikten sonra ajandan ajana (A2A) takip yolunu kullanır:

• Hedef oturumun yanıtını bekleyin.
• İsteğe bağlı olarak, istekte bulunan ile hedefin sınırlı sayıda takip dönüşü alışverişi yapmasına izin verin.
• Hedeften bir duyuru iletisi oluşturmasını isteyin.
• Bu duyuruyu görünür kanala veya ileti dizisine teslim edin.

Bu A2A yolu, gönderenin görünür bir takibe ihtiyaç duyduğu eş gönderimleri için bir geri dönüş yoludur. İlgisiz bir oturumun, örneğin geniş tools.sessions.visibility ayarları altında bir ACP hedefini görebildiği ve hedefe ileti gönderebildiği durumlarda etkin kalır.

OpenClaw, A2A takibini yalnızca istekte bulunan kendi üst öğesinin sahip olduğu tek seferlik ACP alt öğesinin üst öğesiyse atlar. Bu durumda, görev tamamlamanın üzerine A2A çalıştırmak üst öğeyi alt öğenin sonucuyla uyandırabilir, üst öğenin yanıtını tekrar alt öğeye iletebilir ve bir üst öğe/alt öğe yankı döngüsü oluşturabilir. sessions_send sonucu, tamamlanma yolu sonuçtan zaten sorumlu olduğu için bu sahip olunan alt öğe durumunda delivery.status="skipped" bildirir.

Yeni bir oturum başlatmak yerine önceki bir ACP oturumunu sürdürmek için resumeSessionId kullanın. Ajan, konuşma geçmişini session/load üzerinden yeniden oynatır; böylece önceki tüm bağlamla kaldığı yerden devam eder.

{  "task": "Kaldığımız yerden devam et - kalan test hatalarını düzelt",  "runtime": "acp",  "agentId": "codex",  "resumeSessionId": "<previous-session-id>"}

Yaygın kullanım durumları:

• Bir Codex oturumunu dizüstü bilgisayarınızdan telefonunuza devredin; ajanınıza kaldığınız yerden devam etmesini söyleyin.
• CLI'da etkileşimli olarak başlattığınız bir kodlama oturumunu artık ajanınız üzerinden gözetimsiz olarak sürdürün.
• Gateway yeniden başlatması veya boşta kalma zaman aşımı nedeniyle kesintiye uğrayan çalışmayı sürdürün.

Notlar:

• resumeSessionId yalnızca runtime: "acp" olduğunda geçerlidir; varsayılan alt ajan çalışma zamanı, yalnızca ACP'ye özgü bu alanı yok sayar.
• streamTo yalnızca runtime: "acp" olduğunda geçerlidir; varsayılan alt ajan çalışma zamanı, yalnızca ACP'ye özgü bu alanı yok sayar.
• resumeSessionId, bir OpenClaw kanal oturumu anahtarı değil, ana bilgisayara yerel bir ACP/harness sürdürme kimliğidir; OpenClaw gönderimden önce ACP oluşturma politikasını ve hedef ajan politikasını yine denetlerken üst akış kimliğini yüklemeye ilişkin yetkilendirme ACP backend'ine veya harness'e aittir.
• resumeSessionId, üst akış ACP konuşma geçmişini geri yükler; thread ve mode, oluşturduğunuz yeni OpenClaw oturumuna normal şekilde uygulanmaya devam eder, dolayısıyla mode: "session" yine thread: true gerektirir.
• Hedef ajan session/load desteğine sahip olmalıdır (Codex ve Claude Code destekler).
• Oturum kimliği bulunamazsa oluşturma işlemi açık bir hatayla başarısız olur; yeni bir oturuma sessizce geri dönüş yapılmaz.

Bir Gateway dağıtımından sonra birim testlerine güvenmek yerine canlı bir uçtan uca denetim çalıştırın:

1. Dağıtılan Gateway sürümünü ve hedef ana bilgisayardaki commit'i doğrulayın.
2. Canlı bir ajana geçici bir ACPX köprü oturumu açın.
3. Bu ajandan runtime: "acp", agentId: "codex", mode: "run" ve Reply with exactly LIVE-ACP-SPAWN-OK göreviyle sessions_spawn çağrısı yapmasını isteyin.
4. accepted=yes, gerçek bir childSessionKey ve doğrulayıcı hatası bulunmadığını doğrulayın.
5. Geçici köprü oturumunu temizleyin.

Geçidi mode: "run" üzerinde tutun ve streamTo: "parent" öğesini atlayın; ileti dizisine bağlı mode: "session" ve akış aktarma yolları, ayrı ve daha kapsamlı entegrasyon geçişleridir.