پل پیکابو

OpenClaw می‌تواند PeekabooBridge را به‌عنوان یک واسطهٔ محلی اتوماسیون UI با آگاهی از مجوزها میزبانی کند. این باعث می‌شود CLI peekaboo بتواند اتوماسیون UI را اجرا کند و هم‌زمان از مجوزهای TCC برنامهٔ macOS دوباره استفاده کند.

این چیست (و چیست نیست)

• میزبان: OpenClaw.app می‌تواند به‌عنوان میزبان PeekabooBridge عمل کند.
• کلاینت: از CLI peekaboo استفاده کنید (بدون سطح جداگانهٔ openclaw ui ...).
• UI: هم‌پوشانی‌های بصری در Peekaboo.app باقی می‌مانند؛ OpenClaw فقط یک میزبان واسطهٔ سبک است.

رابطه با Computer Use

OpenClaw سه مسیر کنترل دسکتاپ دارد، و این مسیرها عمداً جدا از هم می‌مانند:

• میزبان PeekabooBridge: OpenClaw.app می‌تواند سوکت محلی PeekabooBridge را میزبانی کند. CLI peekaboo همچنان کلاینت باقی می‌ماند و از مجوزهای macOS متعلق به OpenClaw.app برای بدوی‌های اتوماسیون Peekaboo مانند اسکرین‌شات‌ها، کلیک‌ها، منوها، دیالوگ‌ها، کنش‌های Dock، و مدیریت پنجره استفاده می‌کند.
• Codex Computer Use: Plugin داخلی codex سرور برنامهٔ Codex را آماده می‌کند، بررسی می‌کند که سرور MCP computer-use متعلق به Codex در دسترس باشد، و سپس اجازه می‌دهد Codex در نوبت‌های حالت Codex مالک فراخوانی‌های ابزار کنترل دسکتاپ بومی باشد. OpenClaw این کنش‌ها را از طریق PeekabooBridge پراکسی نمی‌کند.
• MCP مستقیم cua-driver: OpenClaw می‌تواند سرور بالادستی cua-driver mcp متعلق به TryCua را به‌عنوان یک سرور MCP عادی ثبت کند. این کار به عامل‌ها طرح‌واره‌های خود درایور CUA و گردش‌کار pid/پنجره/نمایهٔ عنصر را می‌دهد، بدون اینکه از طریق بازار Codex یا سوکت PeekabooBridge مسیریابی شود.

وقتی سطح گستردهٔ اتوماسیون macOS و میزبان پل با آگاهی از مجوزهای OpenClaw.app را می‌خواهید، از Peekaboo استفاده کنید. وقتی یک عامل حالت Codex باید به Plugin بومی computer-use متعلق به Codex تکیه کند، از Codex Computer Use استفاده کنید. وقتی می‌خواهید درایور CUA برای هر runtime مدیریت‌شده توسط OpenClaw به‌عنوان یک سرور MCP عادی در معرض استفاده قرار گیرد، از cua-driver mcp مستقیم استفاده کنید.

فعال‌سازی پل

در برنامهٔ macOS:

• Settings → Enable Peekaboo Bridge

وقتی فعال باشد، OpenClaw یک سرور سوکت UNIX محلی را راه‌اندازی می‌کند. اگر غیرفعال باشد، میزبان متوقف می‌شود و peekaboo به میزبان‌های دردسترس دیگر بازمی‌گردد.

ترتیب کشف کلاینت

کلاینت‌های Peekaboo معمولاً میزبان‌ها را به این ترتیب امتحان می‌کنند:

1. Peekaboo.app (تجربهٔ کاربری کامل)
2. Claude.app (اگر نصب شده باشد)
3. OpenClaw.app (واسطهٔ سبک)

برای دیدن اینکه کدام میزبان فعال است و کدام مسیر سوکت در حال استفاده است، از peekaboo bridge status --verbose استفاده کنید. می‌توانید با این مورد بازنویسی کنید:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

امنیت و مجوزها

• پل امضاهای کد فراخوان را اعتبارسنجی می‌کند؛ یک فهرست مجاز از TeamIDها اعمال می‌شود (TeamID میزبان Peekaboo + TeamID برنامهٔ OpenClaw).
• برای دسترسی‌پذیری، هویت امضاشدهٔ پل/برنامه را به runtime عمومی node ترجیح دهید. اعطای دسترسی‌پذیری به node باعث می‌شود هر بسته‌ای که توسط آن فایل اجرایی Node راه‌اندازی شود، دسترسی اتوماسیون GUI را به ارث ببرد؛ مجوزهای macOS را ببینید.
• درخواست‌ها پس از حدود ۱۰ ثانیه منقضی می‌شوند.
• اگر مجوزهای لازم وجود نداشته باشند، پل به‌جای راه‌اندازی System Settings یک پیام خطای روشن برمی‌گرداند.

رفتار Snapshot (اتوماسیون)

Snapshotها در حافظه ذخیره می‌شوند و پس از یک بازهٔ کوتاه به‌طور خودکار منقضی می‌شوند. اگر به نگهداری طولانی‌تر نیاز دارید، دوباره از کلاینت capture بگیرید.

عیب‌یابی

• اگر peekaboo گزارش داد "bridge client is not authorized"، مطمئن شوید کلاینت به‌درستی امضا شده است یا میزبان را فقط در حالت debug با PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 اجرا کنید.
• اگر هیچ میزبانی پیدا نشد، یکی از برنامه‌های میزبان (Peekaboo.app یا OpenClaw.app) را باز کنید و تأیید کنید که مجوزها اعطا شده‌اند.

مرتبط

• برنامهٔ macOS
• مجوزهای macOS