macOS companion app

Peekaboo köprüsü

OpenClaw, PeekabooBridge'i yerel, izin duyarlı bir kullanıcı arayüzü otomasyon aracısı olarak barındırabilir (PeekabooBridgeHostCoordinator, steipete/Peekaboo Swift paketi tarafından desteklenir). Bu, peekaboo CLI'ın macOS uygulamasının TCC izinlerini yeniden kullanarak kullanıcı arayüzü otomasyonunu yürütmesini sağlar.

Bu nedir (ve ne değildir)

Ana makine: OpenClaw.app, PeekabooBridge ana makinesi olarak çalışabilir.
İstemci: peekaboo CLI (ayrı bir openclaw ui ... yüzeyi yoktur).
Kullanıcı arayüzü: görsel katmanlar Peekaboo.app içinde kalır; OpenClaw, ince bir aracı ana makinedir.

Diğer masaüstü denetimi yollarıyla ilişkisi

OpenClaw, bilinçli olarak birbirinden ayrı tutulan dört masaüstü denetimi yoluna sahiptir:

PeekabooBridge ana makinesi: OpenClaw.app, yerel PeekabooBridge soketini barındırır. peekaboo CLI istemcidir ve ekran görüntüleri, tıklamalar, menüler, iletişim kutuları, Dock eylemleri ve pencere yönetimi için OpenClaw.app'in macOS izinlerini kullanır.
Aracı tarafından yürütülen bilgisayar kullanımı (computer.act): Gateway aracısının yerleşik computer aracı, screen.snapshot üzerinden ekran görüntüleri yakalar ve tehlikeli computer.act Node komutuyla işaretçiyi ve klavyeyi denetler. Bir macOS Node'u, PeekabooBridge soketinden veya peekaboo CLI'dan geçmeden, bu köprünün sunduğu gömülü Peekaboo otomasyon hizmetlerini ve sınırlı CoreGraphics temel işlevlerini kullanarak computer.act işlemini süreç içinde gerçekleştirir. Bkz. Bilgisayar kullanımı.
Codex Bilgisayar Kullanımı: paketle birlikte gelen codex Plugin, Codex'in computer-use MCP Plugin'ini (extensions/codex/src/app-server/computer-use.ts) denetler ve yükleyebilir; ardından Codex modu turları sırasında yerel masaüstü denetimi araç çağrılarının sahipliğini Codex'e verir. OpenClaw bu eylemleri PeekabooBridge üzerinden vekil olarak iletmez.
Doğrudan cua-driver MCP: OpenClaw, TryCua'nın üst kaynak cua-driver mcp sunucusunu normal bir MCP sunucusu olarak kaydedebilir; böylece aracılara Codex pazar yeri 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.

OpenClaw.app'in izin duyarlı köprü ana makinesi üzerinden geniş macOS otomasyon yüzeyi için Peekaboo'yu kullanın. Gateway aracısının masaüstünü herhangi bir görsel modelin kullanabileceği tek biçimli bir computer.act Node komutu üzerinden görmesi ve denetlemesi gerektiğinde, aracı tarafından yürütülen bilgisayar kullanımını tercih edin. Codex modu aracısının Codex'in yerel Plugin'ine dayanması gerektiğinde Codex Bilgisayar Kullanımı'nı tercih edin. CUA sürücüsünü OpenClaw tarafından yönetilen herhangi bir çalışma zamanına normal bir MCP sunucusu olarak sunmak için doğrudan cua-driver mcp kullanın.

Köprüyü etkinleştirme

macOS uygulamasında: Settings -> Enable Peekaboo Bridge. Her ikisi de yerel kullanıcı arayüzü otomasyonuna izin verdiğinden, bu düğmenin kullanılabilmesi için Allow Computer Control açık olmalıdır; Computer Control kapalıyken düğme devre dışıdır ve ana makine çalışmaz. Peekaboo'yu Computer Control olmadan kullanmak için bunun yerine Peekaboo'nun kendi Mac uygulamasını ana makine olarak çalıştırın.

Etkinleştirildiğinde (ve Computer Control açıkken), OpenClaw ~/Library/Application Support/OpenClaw/<socket-name> konumunda yerel bir UNIX soket sunucusu başlatır. Devre dışı bırakıldığında ana makine durur ve peekaboo kullanılabilir diğer ana makinelere geri döner. Koordinatör ayrıca eski peekaboo kurulumları için geçerli soketi işaret eden eski soket sembolik bağlantılarını (Application Support altında clawdbot, clawdis, moltbot) korur.

İstemci keşif sırası

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

Peekaboo.app (tam kullanıcı deneyimi)
Claude.app (yüklüyse)
OpenClaw.app (ince aracı)

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

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Güvenlik ve izinler

Köprü, çağıranın kod imzalarını doğrular; TeamID izin listesi zorunlu tutulur (Peekaboo ana makinesinin TeamID'si ve çalışan uygulamanın kendi TeamID'si).
Erişilebilirlik için genel bir node çalışma zamanı yerine imzalı köprü/uygulama kimliğini tercih edin. node için Erişilebilirlik izni verilmesi, bu Node yürütülebilir dosyası tarafından başlatılan her paketin grafik kullanıcı arayüzü otomasyon erişimini devralmasına olanak tanır; bkz. macOS izinleri.
İstekler 10 saniye sonra zaman aşımına uğrar (requestTimeoutSec: 10).
Gerekli izinler eksikse köprü, System Settings'i 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, 10 dakikalık geçerlilik aralığı ve 50 anlık görüntü sınırıyla (InMemorySnapshotManager) bellekte saklanır; yapıtlar temizleme sırasında silinmez. Daha uzun süre saklamanız 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 makineyi yalnızca debug modunda PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 ile çalıştırın.
Hiçbir ana makine bulunamazsa ana makine uygulamalarından birini (Peekaboo.app veya OpenClaw.app) açın ve izinlerin verildiğini doğrulayın.

İlgili

Was this useful?