> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

1. Peekaboo.app (tam UX)
2. Claude.app (kuruluysa)
3. 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/tr/platforms/mac/permissions#accessibility-grants-for-node-and-cli-runtimes).
* İ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

* [macOS uygulaması](/tr/platforms/macos)
* [macOS izinleri](/tr/platforms/mac/permissions)