Jembatan Peekaboo

OpenClaw dapat meng-host PeekabooBridge sebagai broker otomasi UI lokal yang sadar izin. Ini memungkinkan CLI peekaboo menjalankan otomasi UI sambil menggunakan ulang izin TCC aplikasi macOS.

# Apa ini (dan bukan ini)

• Host: OpenClaw.app dapat bertindak sebagai host PeekabooBridge.
• Klien: gunakan CLI peekaboo (tanpa permukaan openclaw ui ... terpisah).
• UI: overlay visual tetap berada di Peekaboo.app; OpenClaw adalah host broker tipis.

# Hubungan dengan Computer Use

OpenClaw memiliki tiga jalur kontrol desktop, dan ketiganya sengaja tetap terpisah:

• Host PeekabooBridge: OpenClaw.app dapat meng-host soket PeekabooBridge lokal. CLI peekaboo tetap menjadi klien dan menggunakan izin macOS OpenClaw.app untuk primitif otomasi Peekaboo seperti tangkapan layar, klik, menu, dialog, tindakan Dock, dan manajemen jendela.
• Codex Computer Use: plugin codex bawaan menyiapkan server aplikasi Codex, memverifikasi bahwa server MCP computer-use Codex tersedia, lalu membiarkan Codex memiliki panggilan alat kontrol desktop native selama giliran mode Codex. OpenClaw tidak mem-proxy tindakan tersebut melalui PeekabooBridge.
• MCP cua-driver langsung: OpenClaw dapat mendaftarkan server upstream cua-driver mcp TryCua sebagai server MCP biasa. Itu memberi agen skema milik driver CUA dan alur kerja pid/jendela/indeks-elemen tanpa merutekan melalui marketplace Codex atau soket PeekabooBridge.

Gunakan Peekaboo saat Anda menginginkan permukaan otomasi macOS yang luas dan host bridge OpenClaw.app yang sadar izin. Gunakan Codex Computer Use saat agen mode Codex harus mengandalkan plugin computer-use native Codex. Gunakan cua-driver mcp langsung saat Anda ingin driver CUA diekspos ke runtime yang dikelola OpenClaw sebagai server MCP biasa.

# Aktifkan bridge

Di aplikasi macOS:

• Pengaturan → Aktifkan Peekaboo Bridge

Saat diaktifkan, OpenClaw memulai server soket UNIX lokal. Jika dinonaktifkan, host dihentikan dan peekaboo akan kembali ke host lain yang tersedia.

# Urutan penemuan klien

Klien Peekaboo biasanya mencoba host dalam urutan ini:

1. Peekaboo.app (UX lengkap)
2. Claude.app (jika terpasang)
3. OpenClaw.app (broker tipis)

Gunakan peekaboo bridge status --verbose untuk melihat host mana yang aktif dan path soket mana yang sedang digunakan. Anda dapat mengganti dengan:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

# Keamanan dan izin

• Bridge memvalidasi tanda tangan kode pemanggil; allowlist TeamID diberlakukan (TeamID host Peekaboo + TeamID aplikasi OpenClaw).
• Permintaan timeout setelah ~10 detik.
• Jika izin yang diperlukan tidak ada, bridge mengembalikan pesan kesalahan yang jelas alih-alih meluncurkan Pengaturan Sistem.

# Perilaku snapshot (otomasi)

Snapshot disimpan dalam memori dan kedaluwarsa secara otomatis setelah jendela singkat. Jika Anda membutuhkan retensi yang lebih lama, ambil ulang dari klien.

# Pemecahan masalah

• Jika peekaboo melaporkan "bridge client is not authorized", pastikan klien ditandatangani dengan benar atau jalankan host dengan PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 hanya dalam mode debug.
• Jika tidak ada host yang ditemukan, buka salah satu aplikasi host (Peekaboo.app atau OpenClaw.app) dan konfirmasi bahwa izin telah diberikan.

# Terkait

• aplikasi macOS
• izin macOS