پل دالی‌موشه

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

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

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

# رابطه با Computer Use

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

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

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

# فعال کردن پل

در اپ macOS:

• تنظیمات → فعال‌سازی 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).
• درخواست‌ها پس از حدود ۱۰ ثانیه منقضی می‌شوند.
• اگر مجوزهای لازم وجود نداشته باشند، پل به‌جای راه‌اندازی System Settings یک پیام خطای روشن برمی‌گرداند.

# رفتار نماگرفت (اتوماسیون)

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

# عیب‌یابی

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

# مرتبط

• اپ macOS
• مجوزهای macOS