Skip to main content
Computer Use, yerel masaüstü denetimi için Codex’e özgü bir MCP Plugin’idir. OpenClaw masaüstü uygulamasını paketine dahil etmez, masaüstü eylemlerini kendisi yürütmez veya Codex izinlarını atlamaz. Birlikte gelen codex Plugin’i yalnızca Codex app-server’ı hazırlar: Codex Plugin desteğini etkinleştirir, yapılandırılmış Computer Use Plugin’ini bulur veya yükler, computer-use MCP sunucusunun kullanılabilir olduğunu denetler ve ardından Codex modundaki turlar sırasında yerel MCP araç çağrılarının denetimini Codex’e bırakır. Bu sayfayı OpenClaw zaten yerel Codex harness’ını kullanıyorsa kullanın. Çalışma zamanı kurulumunun kendisi için Codex harness sayfasına bakın. Bu, OpenClaw’ın yerleşik Node destekli bilgisayar aracından farklıdır. Aynı ajan sözleşmesinin, ajan ister Gateway’de ister başka bir Node’da çalışsın, eşleştirilmiş bir Mac’i denetlemesi gerekiyorsa yerleşik aracı kullanın. Codex app-server’ın yerel MCP kurulumunu, izinleri ve yerel araç çağrılarını yönetmesi gerektiğinde Codex Computer Use’ı kullanın.

​
OpenClaw.app ve Peekaboo

OpenClaw.app’in Peekaboo entegrasyonu, Codex Computer Use’dan ayrıdır. macOS uygulaması, peekaboo CLI’ın Peekaboo’nun kendi otomasyon araçları için uygulamanın yerel Erişilebilirlik ve Ekran Kaydı izinlerini yeniden kullanabilmesi amacıyla bir PeekabooBridge yuvası barındırabilir. Bu köprü Codex Computer Use’ı yüklemez veya ona proxy görevi görmez ve Codex Computer Use, PeekabooBridge yuvası üzerinden çağrı yapmaz. OpenClaw.app’in Peekaboo CLI otomasyonu için izinleri dikkate alan bir ana makine olmasını istediğinizde Peekaboo köprüsünü kullanın. Codex modundaki bir OpenClaw ajanının, tur başlamadan önce Codex’in yerel computer-use MCP Plugin’ini kullanabilmesi gerektiğinde bu sayfayı kullanın.

​
iOS uygulaması

iOS uygulaması, Codex Computer Use’dan ayrıdır. Codex computer-use MCP sunucusunu yüklemez veya ona proxy görevi görmez ve bir masaüstü denetimi arka ucu değildir. Bunun yerine iOS uygulaması bir OpenClaw Node’u olarak bağlanır ve canvas.*, camera.*, screen.*, location.* ve talk.* gibi Node komutları üzerinden mobil yetenekler sunar. Bir ajanın Gateway üzerinden bir iPhone Node’unu yönetmesini istediğinizde iOS sayfasını kullanın. Codex modundaki bir ajanın Codex’in yerel Computer Use Plugin’i üzerinden yerel macOS masaüstünü denetlemesi gerektiğinde bu sayfayı kullanın.

​
Doğrudan cua-driver MCP

Masaüstü denetimi sunmanın tek yolu Codex Computer Use değildir. OpenClaw tarafından yönetilen çalışma zamanlarının TryCua sürücüsünü doğrudan çağırmasını istiyorsanız Codex’e özgü pazar yeri akışı yerine OpenClaw’ın MCP kayıt defteri üzerinden yukarı akış cua-driver mcp sunucusunu kullanın. cua-driver yüklendikten sonra ya OpenClaw komutunu vermesini isteyin:
ya da stdio sunucusunu doğrudan kaydedin:
Bu yol, sürücü şemaları ve yapılandırılmış MCP yanıtları dahil olmak üzere yukarı akış MCP araç yüzeyini değiştirmeden korur. CUA sürücüsünün normal bir OpenClaw MCP sunucusu olarak kullanılabilmesini istediğinizde bunu kullanın. Codex app-server’ın Codex modundaki turlar içinde Plugin kurulumunu, MCP yeniden yüklemelerini ve yerel araç çağrılarını yönetmesi gerektiğinde bu sayfadaki Codex Computer Use kurulumunu kullanın. CUA sürücüsü; macOS, Windows (x64 ve ARM64) ve Linux (x64 ve ARM64, önizleme katmanı) için ön sürüm derlemeleri sunar. Yine de uygulamasının macOS’taki Erişilebilirlik ve Ekran Kaydı gibi istediği yerel işletim sistemi izinlerini gerektirir. OpenClaw, cua-driver’ı yüklemez, bu izinleri vermez veya yukarı akış sürücüsünün güvenlik modelini atlamaz.

​
Hızlı kurulum

Codex modundaki turlarda bir iş parçacığı başlamadan önce Computer Use’ın kullanılabilir olması gerekiyorsa plugins.entries.codex.config.computerUse değerini ayarlayın. autoInstall: true, Computer Use’ı etkinleştirir ve OpenClaw’ın turdan önce onu yüklemesine veya yeniden etkinleştirmesine olanak tanır:
Bu yapılandırmayla OpenClaw, Codex modundaki her turdan önce Codex app-server’ı denetler. Computer Use eksikse ancak Codex app-server yüklenebilir bir pazar yerini zaten keşfetmişse OpenClaw, Codex app-server’dan Plugin’i yüklemesini veya yeniden etkinleştirmesini ve MCP sunucularını yeniden yüklemesini ister. macOS’ta yalıtılmış bir Codex app-server’ı başlatmadan önce otomatik yükleme, yerel istemci eksik olduğunda seçilen masaüstü uygulama paketindeki resmî imzalı Computer Use hizmet uygulamasını da ilgili Codex ana dizininin computer-use dizinine kopyalar. macOS’ta eşleşen bir pazar yeri kayıtlı değilse ve standart bir masaüstü uygulama paketi mevcutsa OpenClaw, /Applications/Codex.app/Contents/Resources/plugins/openai-bundled’ı eski bağımsız kurulumlar için geri dönüş olarak koruyarak /Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled konumundaki paketlenmiş Codex pazar yerini de kaydetmeye çalışır. Kurulum yine de MCP sunucusunu kullanılabilir hâle getiremezse tur, iş parçacığı başlamadan önce başarısız olur. Katı hazırlık hataları harness ön kontrol hatalarıdır; bu nedenle model geri dönüşü, her model adayı için aynı yerel hazırlık dizisini tekrarlamaz. Computer Use yapılandırmasını değiştirdikten sonra mevcut bir Codex iş parçacığı zaten başladıysa testten önce etkilenen sohbette /new veya /reset kullanın. macOS’ta Computer Use için yönetilen başlatma, önce /Applications/ChatGPT.app/Contents/Resources/codex konumundaki masaüstü uygulama ikilisini tercih eder, ardından eski bağımsız kurulumlar için /Applications/Codex.app/Contents/Resources/codex konumuna geri döner. Bu, kendi istemcisini başlatan tek seferlik Computer Use durum ve yükleme komutları için de geçerlidir. Böylece masaüstü denetimi, yerel macOS izinlerinin sahibi olan uygulama paketinin altında kalır. Masaüstü uygulaması yüklü değilse OpenClaw, Plugin’in yanına yüklenmiş yönetilen Codex ikilisine geri döner. Varsayılan yalıtılmış ajan ana dizinini kullanan sıradan yönetilen Codex turları, eski bir masaüstü uygulamasının güncel model desteğini gölgelememesi için önce sabitlenmiş paketi tercih eder. Kullanıcı kapsamlı ana dizinler, yerel Computer Use durumunu yükleyebildikleri için masaüstünü öncelemeye devam eder. Etkin Codex yapılandırması Computer Use’ı etkinleştiren yalıtılmış bir ajan ana dizini de masaüstünü öncelemeye devam eder. Açık appServer.command yapılandırması veya OPENCLAW_CODEX_APP_SERVER_BIN yine de bu yönetilen seçimi geçersiz kılar. OpenClaw, çalışan tek bir Gateway içinde yerel Codex yapılandırma okumalarını ve Computer Use kurulumunu seri hâle getirir. Ayrı bir Codex işlemi veya başka bir Gateway bu korumanın parçası değildir. Yerel Codex Plugin yapılandırmasını Gateway dışında değiştirdikten sonra yeni seçime güvenmeden önce Gateway’i yeniden başlatın ve yeni bir sohbet başlatın.

​
Komutlar

codex Plugin komut yüzeyinin kullanılabildiği herhangi bir sohbet yüzeyinden /codex computer-use komutlarını kullanın. Bunlar openclaw codex ... CLI alt komutları değil, OpenClaw sohbet/çalışma zamanı komutlarıdır:
status varsayılan eylemdir ve salt okunurdur: pazar yeri kaynakları eklemez, Plugin yüklemez veya Codex Plugin desteğini etkinleştirmez. Hiçbir yapılandırma Computer Use’ı etkinleştirmiyorsa status, tek seferlik bir yükleme komutundan sonra bile devre dışı olduğunu bildirebilir. install, Codex app-server Plugin desteğini etkinleştirir, isteğe bağlı olarak yapılandırılmış bir pazar yeri kaynağı ekler, yapılandırılmış Plugin’i Codex app-server üzerinden yükler veya yeniden etkinleştirir, MCP sunucularını yeniden yükler ve MCP sunucusunun araçlar sunduğunu doğrular. Kurulum güvenilen ana makine kaynaklarını değiştirdiği için yalnızca bir sahip veya operator.admin Gateway istemcisi install komutunu çalıştırabilir. Diğer yetkili göndericiler, geçersiz kılmalarla birlikte de salt okunur status komutunu kullanmaya devam edebilir. Eski sürümler tek seferlik --plugin, --server ve --mcp-server kimlik geçersiz kılmalarını kabul ediyordu. Bunun yerine computerUse.pluginName ve computerUse.mcpServerName değerlerini kalıcı olarak yapılandırın. Eski bir kimlik bayrağı kullanıldığında komut, kalıcılaştırılacak tam ayarı belirtir ve geçiş kılavuzunda istenen eylemi ve desteklenen tüm pazar yeri bayraklarını tekrarlar.

​
Pazar yeri seçenekleri

OpenClaw, Codex’in kendisinin sunduğu app-server API’sinin aynısını kullanır. Pazar yeri alanları, Codex’in computer-use öğesini nerede bulacağını seçer. Yeni Codex ana dizinlerinin resmî pazar yerlerini hazırlaması kısa bir süre alabilir. Yükleme sırasında OpenClaw, plugin/list için marketplaceDiscoveryTimeoutMs milisaniyeye kadar (varsayılan 60 saniye) yoklama yapar. Bilinen birden fazla pazar yeri Computer Use içeriyorsa OpenClaw önce openai-bundled, ardından openai-curated, sonra local değerini tercih eder. Bilinmeyen ve belirsiz eşleşmeler güvenli biçimde başarısız olur ve marketplaceName veya marketplacePath ayarlamanızı ister.

​
Paketlenmiş macOS pazar yeri

Güncel ChatGPT masaüstü derlemeleri Computer Use’ı burada paketler; eski bağımsız Codex masaüstü derlemeleri Codex.app altında aynı düzeni kullanır:
computerUse.autoInstall true olduğunda ve computer-use içeren hiçbir pazar yeri kayıtlı olmadığında OpenClaw, mevcut olan ilk standart paketlenmiş pazar yeri kökünü eklemeye çalışır:
Bunu Codex ile bir kabuktan açıkça da kaydedebilirsiniz:
Standart olmayan bir Codex uygulama yolu kullanıyorsanız /codex computer-use install --source <marketplace-root> komutunu bir kez çalıştırın veya computerUse.marketplacePath değerini yerel bir pazar yeri dosya yoluna ayarlayın. --marketplace-path değerini yalnızca paketlenmiş pazar yeri köküne değil, pazar yeri JSON dosyasının yoluna sahip olduğunuzda kullanın.

​
Paylaşılan Plugin önbelleği

Varsayılan pluginCacheMode: "independent", her Codex ana dizinini ve onun Plugin önbelleğini yönetimsiz bırakır. App-server başlatılmadan önce paketlenmiş Computer Use Plugin’ini etkin Codex ana dizininin keşfedilebilir Plugin önbelleğine kopyalamak için pluginCacheMode: "shared" ayarını yapın. Paylaşılan mod, çalışan Codex istemcileri sürümlendirilmiş Plugin dizinlerine hâlâ başvurabildiği için eski önbelleğe alınmış sürümleri korur; başarısız bir değiştirme kopyası da etkin önbelleği korur. Açık marketplaceName veya marketplacePath yapılandırması, OpenClaw’ın bu seçimi geçersiz kılmaması için bu uzlaştırmayı devre dışı bırakır.

​
Uzak katalog sınırı

Codex app-server yalnızca uzakta bulunan katalog girdilerini listeleyebilir ve okuyabilir, ancak şu anda uzak plugin/install desteği sunmaz. Bu, marketplaceName değerinin durum denetimleri için yalnızca uzakta bulunan bir pazar yerini seçebileceği, ancak yüklemeler ve yeniden etkinleştirmeler için yine de marketplaceSource veya marketplacePath üzerinden yerel bir pazar yerine ihtiyaç duyulduğu anlamına gelir. Durum, Plugin’in uzak bir Codex pazar yerinde kullanılabilir olduğunu ancak uzak yüklemenin desteklenmediğini belirtiyorsa yüklemeyi yerel bir kaynak veya yolla çalıştırın:

​
Yapılandırma referansı

Tur başlangıcındaki otomatik yükleme, yapılandırılmış marketplaceSource değerlerini bilinçli olarak reddeder. Yeni bir kaynak eklemek açık bir kurulum işlemidir; bu nedenle /codex computer-use install --source <marketplace-source> öğesini bir kez kullanın, ardından keşfedilen yerel pazar yerlerinden gelecekteki yeniden etkinleştirmeleri autoInstall öğesinin yönetmesine izin verin. Tur başlangıcındaki otomatik yükleme, yapılandırılmış bir marketplacePath kullanabilir; çünkü bu zaten ana makinedeki yerel bir yoldur. Her alan, eşleşen yapılandırma anahtarı ayarlanmamış olduğunda denetlenen bir ortam değişkeni geçersiz kılmasını da kabul eder:

​
OpenClaw neyi denetler?

OpenClaw, kararlı bir kurulum nedenini dahili olarak bildirir ve kullanıcıya gösterilen durumu sohbet için biçimlendirir: Sohbet çıktısı; plugin durumunu, MCP sunucusu durumunu, pazar yerini, kullanılabilir olduğunda araçları ve başarısız olan kurulum adımına özgü iletiyi içerir.

​
macOS izinleri

Codex’in sahip olduğu bu Computer Use yolu macOS üzerinde çalışır; burada MCP sunucusunun uygulamaları inceleyebilmesi veya denetleyebilmesi için önce yerel işletim sistemi izinlerine ihtiyacı olabilir. (Windows ve Linux node ana makinelerinde platformlar arası masaüstü denetimi için cua-computer yerine getiricisine bakın.) OpenClaw, Computer Use’ın yüklü olduğunu ancak MCP sunucusunun kullanılamadığını söylüyorsa önce Codex tarafındaki Computer Use kurulumunu doğrulayın:
  • Codex app-server, masaüstü denetiminin gerçekleşmesi gereken aynı ana makinede çalışıyor.
  • Computer Use plugini Codex yapılandırmasında etkin.
  • computer-use MCP sunucusu Codex app-server MCP durumunda görünüyor.
  • macOS, masaüstü denetimi uygulaması için gerekli izinleri verdi.
  • Geçerli ana makine oturumu, denetlenen masaüstüne erişebiliyor.
OpenClaw, computerUse.enabled true olduğunda bilinçli olarak kapalı durumda başarısız olur. Codex modu turu, yapılandırmanın gerektirdiği yerel masaüstü araçları olmadan sessizce ilerlememelidir.

​
Sorun giderme

Durum, yüklü olmadığını söylüyor. /codex computer-use install çalıştırın. Pazar yeri keşfedilmezse --source veya --marketplace-path iletin. Durum, yüklü ancak devre dışı olduğunu söylüyor. /codex computer-use install öğesini yeniden çalıştırın. Codex app-server yüklemesi, plugin yapılandırmasını etkin olarak geri yazar. Durum, uzaktan yüklemenin desteklenmediğini söylüyor. Yerel bir pazar yeri kaynağı veya yolu kullanın. Yalnızca uzak katalog girdileri incelenebilir, ancak geçerli app-server API’si üzerinden yüklenemez. Durum, MCP sunucusunun kullanılamadığını söylüyor. MCP sunucularının yeniden yüklenmesi için yüklemeyi bir kez daha çalıştırın. Kullanılamamaya devam ederse Codex Computer Use uygulamasını, Codex app-server MCP durumunu veya macOS izinlerini düzeltin. Durum veya bir yoklama computer-use.list_apps üzerinde zaman aşımına uğruyor. Plugin ve MCP sunucusu mevcut ancak yerel Computer Use köprüsü yanıt vermedi. Codex Computer Use’dan çıkın veya onu yeniden başlatın; gerekirse Codex Desktop’ı yeniden açın, ardından yeni bir OpenClaw oturumunda tekrar deneyin. Ana makine daha önce Computer Use’ı eski bir yönetilen Codex app-server üzerinden çalıştırdıysa yüklenen plugini masaüstüyle paketlenmiş pazar yerinden yenileyin (bağımsız Codex masaüstü yüklemeleri için Codex.app yolunu kullanın):
Bir Computer Use aracı Native hook relay unavailable diyor. Codex’e özgü araç kancası, yerel köprü veya Gateway yedeği üzerinden etkin bir OpenClaw aktarıcısına ulaşamadı. /new veya /reset ile yeni bir OpenClaw oturumu başlatın. Bir kez çalışıp sonraki bir araç çağrısında yeniden başarısız olursa /new yalnızca geçerli denemeyi temizliyordur; eski iş parçacıklarının ve kanca kayıtlarının bırakılması için Codex app-server’ı veya OpenClaw Gateway’i yeniden başlatın, ardından yeni bir oturumda tekrar deneyin. Tur başlangıcındaki otomatik yükleme bir kaynağı reddediyor. Bu kasıtlıdır. Önce kaynağı açık /codex computer-use install --source <marketplace-source> ile ekleyin; ardından gelecekteki tur başlangıcı otomatik yüklemeleri keşfedilen yerel pazar yerini kullanabilir.

​
İlgili