macOS companion app

Peekaboo köprüsü

OpenClaw, PeekabooBridge'i yerel, izin farkındalığına sahip bir UI otomasyonu aracısı olarak barındırabilir. Bu, peekaboo CLI'nin macOS uygulamasının TCC izinlerini yeniden kullanırken UI otomasyonunu yürütmesini sağlar.

Bunun ne olduğu (ve ne olmadığı)

Ana bilgisayar: OpenClaw.app bir PeekabooBridge ana bilgisayarı olarak davranabilir.
İstemci: peekaboo CLI'yi kullanın (ayrı bir openclaw ui ... yüzeyi yoktur).
UI: görsel katmanlar Peekaboo.app içinde kalır; OpenClaw ince bir aracı ana bilgisayardır.

Computer Use ile ilişkisi

OpenClaw'ın üç masaüstü denetim yolu vardır ve bunlar bilerek ayrı tutulur:

PeekabooBridge ana bilgisayarı: OpenClaw.app yerel PeekabooBridge soketini barındırabilir. peekaboo CLI istemci olarak kalır ve ekran görüntüleri, tıklamalar, menüler, iletişim kutuları, Dock eylemleri ve pencere yönetimi gibi Peekaboo otomasyon ilkelleri için OpenClaw.app'in macOS izinlerini kullanır.
Codex Computer Use: paketle gelen codex Plugin'i Codex uygulama sunucusunu hazırlar, Codex'in computer-use MCP sunucusunun kullanılabilir olduğunu doğrular ve ardından Codex modu dönüşleri sırasında yerel masaüstü denetim aracı çağrılarının Codex'e ait olmasını sağlar. OpenClaw bu eylemleri PeekabooBridge üzerinden vekillemez.
Doğrudan cua-driver MCP: OpenClaw, TryCua'nın upstream cua-driver mcp sunucusunu normal bir MCP sunucusu olarak kaydedebilir. Bu, ajanlara Codex marketplace veya PeekabooBridge soketi üzerinden yönlendirme yapmadan CUA sürücüsünün kendi şemalarını ve pid/pencere/öğe dizini iş akışını sağlar.

Geniş macOS otomasyon yüzeyini ve OpenClaw.app'in izin farkındalığına sahip köprü ana bilgisayarını istediğinizde Peekaboo'yu kullanın. Codex modu ajanının Codex'in yerel computer-use Plugin'ine dayanması gerektiğinde Codex Computer Use'ı kullanın. CUA sürücüsünün, OpenClaw tarafından yönetilen herhangi bir çalışma zamanı ortamına normal bir MCP sunucusu olarak sunulmasını istediğinizde doğrudan cua-driver mcp kullanın.

Köprüyü etkinleştirme

macOS uygulamasında:

Ayarlar → Peekaboo Bridge'i Etkinleştir

Etkinleştirildiğinde OpenClaw yerel bir UNIX soket sunucusu başlatır. Devre dışı bırakılırsa ana bilgisayar durdurulur ve peekaboo diğer kullanılabilir ana bilgisayarlara geri döner.

İstemci keşif sırası

Peekaboo istemcileri genellikle ana bilgisayarları şu sırayla dener:

Peekaboo.app (tam UX)
Claude.app (kuruluysa)
OpenClaw.app (ince aracı)

Hangi ana bilgisayarın etkin olduğunu ve hangi soket yolunun kullanıldığını görmek için peekaboo bridge status --verbose kullanın. Şununla geçersiz kılabilirsiniz:

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Güvenlik ve izinler

Köprü çağıran kod imzalarını doğrular; TeamID'lerden oluşan bir izin listesi uygulanır (Peekaboo ana bilgisayar TeamID'si + OpenClaw uygulama TeamID'si).
Accessibility için genel bir node çalışma zamanı yerine imzalı köprü/uygulama kimliğini tercih edin. node'a Accessibility izni vermek, bu Node yürütülebiliri tarafından başlatılan herhangi bir paketin GUI otomasyonu erişimini devralmasına izin verir; bkz. macOS izinleri.
İstekler yaklaşık 10 saniye sonra zaman aşımına uğrar.
Gerekli izinler eksikse köprü, Sistem Ayarları'nı başlatmak yerine açık bir hata mesajı döndürür.

Anlık görüntü davranışı (otomasyon)

Anlık görüntüler bellekte saklanır ve kısa bir sürenin ardından otomatik olarak sona erer. Daha uzun saklama gerekiyorsa istemciden yeniden yakalayın.

Sorun giderme

peekaboo "bridge client is not authorized" bildirirse istemcinin düzgün şekilde imzalandığından emin olun veya ana bilgisayarı yalnızca hata ayıklama modunda PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 ile çalıştırın.
Ana bilgisayar bulunamazsa ana bilgisayar uygulamalarından birini (Peekaboo.app veya OpenClaw.app) açın ve izinlerin verildiğini doğrulayın.

İlgili

Was this useful?