ACP aracıları

• plugins.allow ayarlanmışsa, bu kısıtlayıcı bir plugin envanteridir ve mutlaka acpx içermelidir; aksi halde yüklü ACP backend'i bilerek engellenir ve /acp doctor eksik allowlist girdisini bildirir.
• Codex ACP adapter'ı acpx plugin'iyle hazırlanır ve mümkün olduğunda yerelde başlatılır.
• Codex ACP yalıtılmış bir CODEX_HOME ile çalışır; OpenClaw, host Codex config'inden güvenilir proje girdilerini ve güvenli model/provider yönlendirme config'ini kopyalar; auth, bildirimler ve hook'lar host config'inde kalır.
• Diğer hedef harness adapter'ları, onları ilk kez kullandığınızda yine npx ile isteğe bağlı olarak getirilebilir.
• Tedarikçi auth bilgisi bu harness için host üzerinde yine mevcut olmalıdır.
• Host'ta npm veya ağ erişimi yoksa, önbellekler önceden ısıtılana veya adapter başka bir yolla yüklenene kadar ilk çalıştırma adapter getirmeleri başarısız olur.

ACP gerçek bir harici harness işlemi başlatır. OpenClaw yönlendirme, arka plan görevi durumu, teslimat, bağlamalar ve politikanın sahibidir; harness kendi provider oturum açma bilgileri, model kataloğu, dosya sistemi davranışı ve yerel araçlarının sahibidir.

OpenClaw'ı suçlamadan önce şunları doğrulayın:

• /acp doctor etkin ve sağlıklı bir backend bildiriyor.
• Bu allowlist ayarlandığında hedef id'ye acp.allowedAgents tarafından izin veriliyor.
• Harness komutu Gateway host'unda başlayabiliyor.
• Bu harness için provider auth mevcut (claude, codex, gemini, opencode, droid vb.).
• Seçilen model bu harness için mevcut - model id'leri harness'lar arasında taşınabilir değildir.
• İstenen cwd mevcut ve erişilebilir, ya da cwd kullanmayıp backend'in varsayılanını kullanmasına izin verin.
• İzin modu işle eşleşiyor. Etkileşimsiz oturumlar yerel izin istemlerine tıklayamaz; bu yüzden yazma/çalıştırma ağırlıklı kodlama çalıştırmaları genellikle başsız ilerleyebilen bir ACPX izin profiline ihtiyaç duyar.

• Başlatma, bir ACP runtime oturumu oluşturur veya sürdürür, ACP metadata'sını OpenClaw oturum deposuna kaydeder ve çalıştırma parent-owned olduğunda bir arka plan görevi oluşturabilir.
• Parent-owned ACP oturumları, runtime oturumu persistent olsa bile arka plan işi olarak ele alınır; tamamlama ve yüzeyler arası teslimat, normal kullanıcıya dönük sohbet oturumu gibi davranmak yerine üst görev bildiricisinden geçer.
• Görev bakımı terminal veya sahipsiz parent-owned tek seferlik ACP oturumlarını kapatır. Persistent ACP oturumları, etkin bir konuşma bağlaması kaldığı sürece korunur; etkin bağlaması olmayan bayat persistent oturumlar kapatılır, böylece sahip görev tamamlandıktan veya görev kaydı gittikten sonra sessizce sürdürülemezler.
• Bağlı 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 hiçbir zaman bağlı bir ACP harness'ına normal prompt metni olarak gönderilmez.
• cancel, backend iptali desteklediğinde etkin dönüşü iptal eder; bağlamayı veya oturum metadata'sını silmez.
• close, OpenClaw açısından ACP oturumunu sonlandırır ve bağlamayı kaldırır. Harness, sürdürmeyi destekliyorsa kendi upstream geçmişini yine tutabilir.
• acpx plugin'i close sonrasında OpenClaw'a ait wrapper ve adapter işlem ağaçlarını temizler ve Gateway başlangıcı sırasında bayat OpenClaw'a ait ACPX yetimlerini toplar.
• Boşta runtime worker'ları acp.runtime.ttlMinutes sonrasında temizlenmeye uygundur; depolanan oturum metadata'sı /acp sessions için kullanılabilir kalır.

Etkin olduğunda yerel Codex plugin'ine yönlendirilmesi gereken doğal dil tetikleyicileri:

• "Bu Discord kanalını Codex'e bağla."
• "Bu sohbeti Codex thread'i <id>'ye ekle."
• "Codex thread'lerini göster, sonra bunu bağla."

Yerel Codex konuşma bağlama, varsayılan sohbet denetimi yoludur. OpenClaw dinamik araçları yine OpenClaw üzerinden yürütülürken, shell/apply-patch gibi Codex yerel araçları Codex içinde yürütülür. Codex yerel araç olayları için OpenClaw, Plugin hook'larının before_tool_call'ı engelleyebilmesi, after_tool_call'ı gözlemleyebilmesi ve Codex PermissionRequest olaylarını OpenClaw onayları üzerinden yönlendirebilmesi için her dönüşe özgü yerel bir hook aktarıcısı enjekte eder. Codex Stop hook'ları OpenClaw before_agent_finalize'a aktarılır; burada Plugin'ler Codex yanıtını sonlandırmadan önce bir model geçişi daha isteyebilir. Aktarıcı bilinçli olarak muhafazakar kalır: Codex yerel araç argümanlarını değiştirmez veya Codex iş parçacığı kayıtlarını yeniden yazmaz. Açık ACP'yi yalnızca ACP çalışma zamanı/oturum modelini istediğinizde kullanın. Gömülü Codex destek sınırı Codex harness v1 destek sözleşmesinde belgelenmiştir.

• eski Codex model ref'leri - doctor tarafından onarılan eski Codex OAuth/abonelik model rotası.
• openai/* - OpenAI aracı dönüşleri 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 Gemini CLI'yi bir iş parçacığında kullan, ardından takipleri aynı iş parçacığında tut."
• "Codex'i arka plan iş parçacığında ACP üzerinden çalıştır."

OpenClaw runtime: "acp" seçer, harness agentId değerini çözer, desteklendiğinde geçerli konuşmaya veya iş parçacığına bağlanır ve kapanana/süresi dolana kadar takipleri o oturuma yönlendirir. Codex bu yolu yalnızca ACP/acpx açık olduğunda veya istenen işlem için yerel Codex Plugin'i kullanılamadığında izler.

sessions_spawn için runtime: "acp" yalnızca ACP etkinse, istekte bulunan sandbox içinde değilse ve bir ACP çalışma zamanı backend'i yüklenmişse duyurulur. acp.dispatch.enabled=false, otomatik ACP iş parçacığı dağıtımını duraklatır ancak açık sessions_spawn({ runtime: "acp" }) çağrılarını gizlemez veya engellemez. codex, claude, droid, gemini veya opencode gibi ACP harness kimliklerini hedefler. Bu giriş açıkça agents.list[].runtime.type="acp" ile yapılandırılmadığı sürece agents_list içinden normal bir OpenClaw yapılandırma aracı kimliği geçirmeyin; bunun yerine varsayılan alt aracı çalışma zamanını kullanın. Bir OpenClaw aracı runtime.type="acp" ile yapılandırıldığında OpenClaw, alttaki harness kimliği olarak runtime.acp.agent değerini kullanır.

• --bind here ve --thread ... birbirini dışlar.
• --bind here yalnızca geçerli konuşma bağlamayı duyuran kanallarda çalışır; aksi halde OpenClaw açık bir desteklenmiyor mesajı döndürür. Bağlamalar Gateway yeniden başlatmaları boyunca kalıcıdır.
• Discord'da spawnSessions, --thread auto|here için alt iş parçacığı oluşturmayı sınırlar - --bind here için değil.
• --cwd olmadan farklı bir ACP aracına spawn yaparsanız OpenClaw varsayılan olarak hedef aracın çalışma alanını devralır. Eksik devralınan yollar (ENOENT/ENOTDIR) backend varsayılanına geri döner; diğer erişim hataları (örn. EACCES) spawn hataları olarak görünür.
• 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 o yüzey için etkin olduğunda /status ve /unfocus da 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.
• Unfocus/close/archive/idle-timeout veya max-age süresinin dolması bağlamayı kaldırır.
• /acp close, /acp cancel, /acp status, /status ve /unfocus Gateway komutlarıdır; ACP harness'ine gönderilen prompt'lar değildir.

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

• acp.enabled=true
• acp.dispatch.enabled varsayılan olarak açıktır (otomatik ACP iş parçacığı dağıtımını 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 spawn'ları etkin (varsayılan: true):
  • Discord: channels.discord.threadBindings.spawnSessions=true
  • Telegram: channels.telegram.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 herhangi bir kanal bağdaştırıcısı.
• Geçerli 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, geçerli konuşmayı ACP oturumuna bağlar.
• /acp spawn ... --thread ..., bir kanal ileti dizisini/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 iletileri doğrudan ACP oturumuna yönlendirilir ve ACP çıktısı aynı kanala/ileti dizisine/konuya geri teslim edilir.

OpenClaw'un koşuma gönderdikleri:

• Normal bağlı takipler, koşum/arka uç desteklediğinde yalnızca eklerle birlikte istem metni olarak gönderilir.
• /acp yönetim komutları ve yerel Gateway komutları ACP gönderiminden önce yakalanır.
• Çalışma zamanı tarafından oluşturulan tamamlama olayları hedef başına somutlaştırılır. OpenClaw aracıları OpenClaw'un dahili çalışma zamanı bağlam zarfını alır; harici ACP koşumları alt sonuç ve yönerge içeren düz bir istem alır. Ham <<&lt;BEGIN_OPENCLAW_INTERNAL_CONTEXT&gt;>> zarfı hiçbir zaman harici koşumlara gönderilmemeli veya ACP kullanıcı transkripti metni olarak kalıcılaştırılmamalıdır.
• ACP transkript girdileri kullanıcıya görünen tetikleyici metni veya düz tamamlama istemini kullanır. Dahili olay meta verileri mümkün olduğunda OpenClaw içinde yapılandırılmış kalır ve kullanıcı tarafından yazılmış sohbet içeriği olarak değerlendirilmez.

Başka bir aracı çalıştırması tarafından başlatılan tek seferlik ACP oturumları, alt aracılara benzer arka plan çocuklarıdır:

• Üst oturum, sessions_spawn({ runtime: "acp", mode: "run" }) ile iş ister.
• Alt oturum kendi ACP koşum oturumunda çalışır.
• Alt dönüşler, yerel alt aracı başlatmalarıyla kullanılan aynı arka plan hattında çalışır; böylece yavaş bir ACP koşumu ilgisiz ana oturum işini engellemez.
• Tamamlama, görev tamamlama duyuru yolu üzerinden geri bildirilir. OpenClaw, harici bir koşuma göndermeden önce dahili tamamlama meta verilerini düz bir ACP istemine dönüştürür; böylece koşumlar yalnızca OpenClaw'a ait çalışma zamanı bağlam işaretlerini görmez.
• Kullanıcıya dönük bir yanıt yararlı olduğunda üst oturum, alt sonucu normal asistan sesiyle yeniden yazar.

Bu yolu üst oturum ile alt oturum arasında eşler arası sohbet olarak değerlendirmeyin. Alt oturumun zaten üst oturuma geri giden bir tamamlama kanalı vardır.

sessions_send, başlatmadan sonra başka bir oturumu hedefleyebilir. Normal eş oturumlar için OpenClaw, iletiyi enjekte ettikten sonra aracıdan aracıya (A2A) takip yolu kullanır:

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

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

OpenClaw, A2A takibini yalnızca istekte bulunan, kendi üst öğesine ait tek seferlik ACP alt öğesinin üst öğesi olduğunda atlar. Bu durumda, görev tamamlanmasının üzerine A2A çalıştırmak üst öğeyi alt öğenin sonucu ile uyandırabilir, üst öğenin yanıtını alt öğeye geri iletebilir ve bir üst öğe/alt öğe yankı döngüsü oluşturabilir. sessions_send sonucu, bu sahip olunan alt öğe durumu için delivery.status="skipped" bildirir çünkü sonuçtan zaten tamamlama yolu sorumludur.

Yeni başlamak yerine önceki bir ACP oturumuna devam etmek için resumeSessionId kullanın. Agent, konuşma geçmişini session/load üzerinden yeniden oynatır; böylece önceki olanların tam bağlamıyla devam eder.

{  "task": "Continue where we left off - fix the remaining test failures",  "runtime": "acp",  "agentId": "codex",  "resumeSessionId": "<previous-session-id>"}

Yaygın kullanım durumları:

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

Notlar:

• resumeSessionId yalnızca runtime: "acp" olduğunda geçerlidir; varsayılan alt agent çalışma zamanı bu yalnızca ACP alanını yok sayar.
• streamTo yalnızca runtime: "acp" olduğunda geçerlidir; varsayılan alt agent çalışma zamanı bu yalnızca ACP alanını yok sayar.
• resumeSessionId, OpenClaw kanal oturumu anahtarı değil, ana makineye yerel bir ACP/harness sürdürme kimliğidir; OpenClaw gönderimden önce ACP oluşturma ilkesini ve hedef agent ilkesini hâlâ denetlerken, bu yukarı akış kimliğini yükleme yetkilendirmesinin sahibi ACP arka ucu veya harness'tır.
• resumeSessionId yukarı akış ACP konuşma geçmişini geri yükler; thread ve mode oluşturduğunuz yeni OpenClaw oturumuna normal şekilde uygulanmaya devam eder, bu nedenle mode: "session" hâlâ thread: true gerektirir.
• Hedef agent session/load desteklemelidir (Codex ve Claude Code destekler).
• Oturum kimliği bulunamazsa oluşturma açık bir hatayla başarısız olur; yeni bir oturuma sessiz geri dönüş yapılmaz.

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

1. Hedef ana makinede dağıtılmış Gateway sürümünü ve commit'i doğrulayın.
2. Canlı bir agent'a geçici bir ACPX köprü oturumu açın.
3. Bu agent'tan runtime: "acp", agentId: "codex", mode: "run" ve Reply with exactly LIVE-ACP-SPAWN-OK göreviyle sessions_spawn çağırmasını isteyin.
4. accepted=yes, gerçek bir childSessionKey ve doğrulayıcı hatası olmadığını doğrulayın.
5. Geçici köprü oturumunu temizleyin.

Kapıyı mode: "run" üzerinde tutun ve streamTo: "parent" seçeneğini atlayın; iş parçacığına bağlı mode: "session" ve akış aktarma yolları ayrı, daha zengin entegrasyon geçişleridir.