ACP aracıları

• plugins.allow ayarlanmışsa kısıtlayıcı bir plugin envanteridir ve mutlaka acpx içermelidir; aksi hâlde yüklü ACP arka ucu bilerek engellenir (/acp doctor, izin listesindeki eksik girdiyi bildirir).
• Codex ACP bağdaştırıcısı acpx pluginiyle 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 çalıştırıcı bağdaştırıcıları ilk kullanımda gerektiğinde npx ile getirilebilir.
• İlgili çalıştırıcı 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 ısıtılana ya da bağdaştırıcı başka bir şekilde 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 çalıştırıcı süreci başlatır. OpenClaw yönlendirmeyi, arka plan görevi durumunu, teslimatı, bağlamaları ve politikayı yönetir; çalıştırıcı ise sağlayıcı oturum açma işlemini, model kataloğunu, dosya sistemi davranışını ve yerel araçlarını yönetir.

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

• /acp doctor, etkin ve sağlıklı bir arka uç bildiriyor.
• İzin listesi ayarlanmışsa hedef kimliğe acp.allowedAgents tarafından izin veriliyor.
• Çalıştırıcı komutu Gateway ana makinesinde başlatılabiliyor.
• İlgili çalıştırıcı için sağlayıcı kimlik doğrulaması mevcut (claude, codex, gemini, opencode, droid vb.).
• Seçilen model ilgili çalıştırıcıda mevcut; model kimlikleri çalıştırıcılar arasında taşınabilir değildir.
• İstenen cwd mevcut ve erişilebilir; aksi hâlde cwd değerini atlayın ve arka ucun varsayılanını kullanmasına izin verin.
• İzin modu işe uygun. Etkileşimsiz oturumlar yerel izin istemlerine tıklayamaz; bu nedenle yoğun yazma/yürütme gerektiren kodlama çalışmaları genellikle gözetimsiz ilerleyebilen bir ACPX izin profili gerektirir.

• 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 süreç tarafından yönetiliyorsa bir arka plan görevi oluşturabilir.
• Üst süreç tarafından yönetilen ACP oturumları, çalışma zamanı oturumu kalıcı olsa bile arka plan işi olarak ele alınır; tamamlanma ve yüzeyler arası teslimat, normal kullanıcıya yönelik sohbet oturumu gibi davranmak yerine üst görev bildirimcisi üzerinden gerçekleşir.
• Görev bakımı, sonlanmış veya sahipsiz, üst süreç 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 kapatılır, böylece sahip görev tamamlandıktan veya görev kaydı kaybolduktan sonra sessizce sürdürülemezler.
• Bağlı takip iletileri, 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 çalıştırıcısına hiçbir zaman normal istem metni olarak gönderilmez.
• Arka uç iptali desteklediğinde cancel etkin turu iptal eder; bağlamayı veya oturum meta verilerini silmez.
• close, OpenClaw açısından ACP oturumunu sonlandırır ve bağlamayı kaldırır. Bir çalıştırıcı, sürdürmeyi destekliyorsa kendi üst akış geçmişini yine de tutabilir.
• acpx plugini, close sonrasında OpenClaw tarafından yönetilen sarmalayıcı ve bağdaştırıcı süreç ağaçlarını temizler ve Gateway başlatılırken eski, OpenClaw tarafından yönetilen ACPX sahipsiz süreçlerini sonlandırır.
• Boştaki çalışma zamanı işçileri, acp.runtime.ttlMinutes sonrasında temizlenmeye uygun hâle gelir; depolanan oturum meta verileri /acp sessions için kullanılabilir kalır.

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

• "Bu Discord kanalını Codex'e bağla."
• "Bu sohbeti <id> Codex ileti dizisine ekle."
• "Codex ileti dizilerini göster, ardından bunu bağla."

Yerel Codex konuşma bağlama, varsayılan sohbet denetimi yoludur. OpenClaw dinamik araçları yine OpenClaw üzerinden çalışırken shell/apply-patch gibi Codex'e özgü araçlar Codex içinde çalışır. Codex'e özgü araç olaylarında OpenClaw, Plugin hook'larının before_tool_call çağrısını engelleyebilmesi, after_tool_call çağrısını gözlemleyebilmesi ve Codex PermissionRequest olaylarını OpenClaw onayları üzerinden yönlendirebilmesi için her turda yerel bir hook aktarıcısı ekler. Codex Stop hook'ları OpenClaw before_agent_finalize hook'una aktarılır; burada plugin'ler Codex yanıtını sonlandırmadan önce modelden bir geçiş daha isteyebilir. Aktarıcı kasıtlı olarak temkinli davranı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ça ACP kullanın. Gömülü Codex destek sınırı, Codex donanımı 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 takip mesajlarını 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" seçeneğini belirler, donanımın agentId değerini çözümler, desteklendiğinde geçerli konuşmaya veya iş parçacığına bağlanır ve kapanana/süresi dolana kadar takip mesajlarını 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 etkin olduğunda, istekte bulunan korumalı alanda olmadığında ve bir ACP çalışma zamanı arka ucu yüklendiğinde duyurulur. 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 donanım kimliklerini hedefler. İlgili girdi açıkça agents.list[].runtime.type="acp" ile yapılandırılmadıkça agents_list içindeki normal bir OpenClaw yapılandırma ajanı kimliğini iletmeyin; 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 donanım kimliği olarak runtime.acp.agent değerini kullanır.

• --bind here ile --thread ... birlikte kullanılamaz.
• --bind here yalnızca geçerli konuşma bağlamayı desteklediğ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, --thread auto|here için alt iş parçacığı oluşturmayı denetler; --bind here için değil.
• --cwd olmadan farklı bir ACP ajanına 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 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.
• Odağı kaldırma/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 donanımına 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 olarak 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ığı oturumu başlatmaları etkinleştirilmiş olmalıdır (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 özgüdür. 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ı.
• Geçerli yerleşik destek: Discord iş parçacıkları/kanalları, Telegram konuları (gruplardaki/süper gruplardaki forum konuları ve DM konuları).
• Plugin kanalları aynı bağlama arabirimi üzerinden destek ekleyebilir.

Etkileşimli oturumlar, görünür bir sohbet yüzeyinde konuşmayı sürdürmek amacıyla 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" bağlamaları, eşleşen konuşmaları aynı ACP oturumuna yönlendirir.

Bağlı konuşmadaki sonraki mesajlar doğrudan ACP oturumuna yönlendirilir ve ACP çıktısı aynı kanala/ileti dizisine/konuya geri teslim edilir.

OpenClaw'ın yürütme ortamına gönderdikleri:

• Normal bağlı takip mesajları, istem metni olarak ve yalnızca yürütme ortamı/arka uç desteklediğinde eklerle birlikte gönderilir.
• /acp yönetim komutları ve yerel Gateway komutları, ACP'ye gönderilmeden ö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 yürütme ortamları ise alt sonuç ve talimatı içeren düz bir istem alır. Ham <<&lt;BEGIN_OPENCLAW_INTERNAL_CONTEXT&gt;>> zarfı hiçbir zaman harici yürütme ortamlarına gönderilmemeli veya ACP kullanıcı dökümü metni olarak kalıcılaştırılmamalıdır.
• ACP döküm 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 başlatılan tek seferlik ACP oturumları, alt ajanlara benzer arka plan alt süreçleridir:

• Üst öğe, sessions_spawn({ runtime: "acp", mode: "run" }) ile iş ister.
• Alt süreç kendi ACP yürütme ortamı oturumunda çalışır.
• Alt dönüşler, yerel alt ajan başlatmalarının kullandığı aynı arka plan hattında çalışır; böylece yavaş bir ACP yürütme ortamı, ilgisiz ana oturum işlerini engellemez.
• Tamamlanma, görev tamamlanma duyuru yolu üzerinden geri bildirilir. OpenClaw, dahili tamamlanma meta verilerini harici bir yürütme ortamına göndermeden önce düz bir ACP istemine dönüştürür; böylece yürütme ortamları 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 sürecin sonucunu normal asistan üslubuyla yeniden yazar.

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

sessions_send, başlatmadan sonra başka bir oturumu hedefleyebilir. Normal eş oturumları için OpenClaw, mesajı ekledikten sonra ajanlar arası (A2A) takip yolunu 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 mesajı oluşturmasını ister.
• Bu duyuruyu görünür kanala veya ileti dizisine teslim eder.

Bu A2A yolu, göndericinin görünür bir takip yanıtına ihtiyaç duyduğu eşler arası gönderimler için bir geri dönüş yoludur. İlgisiz bir oturumun bir ACP hedefini görebildiği ve ona mesaj gönderebildiği durumlarda, örneğin geniş tools.sessions.visibility ayarları altında etkin kalır.

OpenClaw, A2A takip yanıtını yalnızca istekte bulunan taraf kendi üst öğesine ait 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ı alt öğeye geri iletebilir ve bir üst öğe/alt öğe yankı döngüsü oluşturabilir. Tamamlama yolu sonuçtan zaten sorumlu olduğundan, sessions_send sonucu bu sahip olunan alt öğe durumu için delivery.status="skipped" bildirir.

Yeni bir başlangıç yapmak yerine önceki bir ACP oturumunu sürdürmek için resumeSessionId kullanın. Aracı, konuşma geçmişini session/load aracılığıyla yeniden oynatır; böylece daha önce gerçekleşenlerin tüm 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 örnekleri:

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

Notlar:

• resumeSessionId yalnızca runtime: "acp" olduğunda geçerlidir; varsayılan alt aracı çalışma zamanı, yalnızca ACP'ye özgü bu alanı yok sayar.
• streamTo yalnızca runtime: "acp" olduğunda geçerlidir; varsayılan alt aracı çalışma zamanı, yalnızca ACP'ye özgü bu alanı yok sayar.
• resumeSessionId, OpenClaw kanal oturumu anahtarı değil, ana makineye yerel bir ACP/çalıştırma düzeneği sürdürme kimliğidir; OpenClaw, dağıtımdan önce ACP başlatma politikasını ve hedef aracı politikasını yine denetlerken, bu üst sistem kimliğinin yüklenmesine ilişkin yetkilendirme ACP arka ucu veya çalıştırma düzeneği tarafından yönetilir.
• resumeSessionId, üst sistemdeki 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" yine thread: true gerektirir.
• Hedef aracı session/load özelliğini desteklemelidir (Codex ve Claude Code destekler).
• Oturum kimliği bulunamazsa başlatma işlemi açık bir hatayla başarısız olur; yeni bir oturuma sessizce geri dönülmez.

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

1. Hedef ana makinede dağıtılan Gateway sürümünü ve kaydı doğrulayın.
2. Canlı bir aracıya geçici bir ACPX köprü oturumu açın.
3. Bu aracıdan 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" seçeneğini atlayın; iş parçacığına bağlı mode: "session" ve akış aktarma yolları, ayrı ve daha kapsamlı entegrasyon geçişleridir.