macOS companion app

Jembatan Peekaboo

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

Apa ini (dan bukan)

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 Penggunaan Komputer

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 otomatisasi Peekaboo seperti tangkapan layar, klik, menu, dialog, aksi Dock, dan manajemen jendela.
Penggunaan Komputer Codex: 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 aksi tersebut melalui PeekabooBridge.
MCP cua-driver langsung: OpenClaw dapat mendaftarkan server upstream cua-driver mcp milik TryCua sebagai server MCP normal. Ini 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 otomatisasi macOS yang luas dan host bridge sadar izin milik OpenClaw.app. Gunakan Penggunaan Komputer Codex saat agen mode Codex harus mengandalkan plugin penggunaan komputer native Codex. Gunakan cua-driver mcp langsung saat Anda ingin driver CUA diekspos ke runtime yang dikelola OpenClaw sebagai server MCP normal.

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 menggunakan host lain yang tersedia.

Urutan penemuan klien

Klien Peekaboo biasanya mencoba host dalam urutan ini:

Peekaboo.app (UX lengkap)
Claude.app (jika terinstal)
OpenClaw.app (broker tipis)

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

bash

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).
Pilih identitas bridge/aplikasi yang ditandatangani dibanding runtime node generik untuk Aksesibilitas. Memberikan Aksesibilitas ke node memungkinkan paket apa pun yang diluncurkan oleh executable Node tersebut mewarisi akses otomatisasi GUI; lihat izin macOS.
Permintaan timeout setelah ~10 detik.
Jika izin yang diperlukan tidak ada, bridge mengembalikan pesan kesalahan yang jelas alih-alih membuka Pengaturan Sistem.

Perilaku snapshot (otomatisasi)

Snapshot disimpan di memori dan kedaluwarsa secara otomatis setelah jendela waktu yang singkat. Jika Anda memerlukan retensi lebih lama, tangkap 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 pastikan izin telah diberikan.

Terkait

Was this useful?