macOS companion app

جسر الغميضة

يمكن لـ OmeniaClaw استضافة PeekabooBridge كوسيط محلي لأتمتة واجهة المستخدم واعٍ بالأذونات. يتيح ذلك لـ CLI الخاص بـ peekaboo قيادة أتمتة واجهة المستخدم مع إعادة استخدام أذونات TCC لتطبيق macOS.

ما هذا (وما ليس كذلك)

المضيف: يمكن لـ OmeniaClaw.app أن يعمل كمضيف لـ PeekabooBridge.
العميل: استخدم CLI الخاص بـ peekaboo (لا توجد واجهة OmeniaClaw ui ... منفصلة).
واجهة المستخدم: تبقى التراكبات المرئية في Peekaboo.app؛ أما OmeniaClaw فهو مضيف وسيط خفيف.

العلاقة مع استخدام الكمبيوتر

لدى OmeniaClaw ثلاثة مسارات للتحكم بسطح المكتب، وهي منفصلة عمدًا:

مضيف PeekabooBridge: يمكن لـ OmeniaClaw.app استضافة مقبس PeekabooBridge المحلي. يظل CLI الخاص بـ peekaboo هو العميل ويستخدم أذونات macOS الخاصة بـ OmeniaClaw.app لبدائيات أتمتة Peekaboo مثل لقطات الشاشة، والنقرات، والقوائم، ومربعات الحوار، وإجراءات Dock، وإدارة النوافذ.
استخدام الكمبيوتر في Codex: يجهّز Plugin المضمّن codex خادم تطبيق Codex، ويتحقق من توفر خادم MCP الخاص بـ computer-use في Codex، ثم يتيح لـ Codex امتلاك استدعاءات أدوات التحكم الأصلي بسطح المكتب أثناء دورات وضع Codex. لا يقوم OmeniaClaw بتمرير هذه الإجراءات عبر PeekabooBridge.
MCP المباشر لـ cua-driver: يمكن لـ OmeniaClaw تسجيل خادم cua-driver mcp upstream الخاص بـ TryCua كخادم MCP عادي. يمنح ذلك الوكلاء مخططات برنامج تشغيل CUA الخاصة به وسير عمل pid/window/element-index من دون التوجيه عبر سوق Codex أو مقبس PeekabooBridge.

استخدم Peekaboo عندما تريد سطح أتمتة macOS واسعًا ومضيف الجسر الواعي بالأذونات في OmeniaClaw.app. استخدم استخدام الكمبيوتر في Codex عندما ينبغي لوكيل وضع Codex الاعتماد على Plugin استخدام الكمبيوتر الأصلي في Codex. استخدم cua-driver mcp المباشر عندما تريد إتاحة برنامج تشغيل CUA لأي وقت تشغيل مُدار بواسطة OmeniaClaw كخادم MCP عادي.

تفعيل الجسر

في تطبيق macOS:

الإعدادات ← Enable Peekaboo Bridge

عند التفعيل، يبدأ OmeniaClaw خادم مقبس UNIX محليًا. عند التعطيل، يتم إيقاف المضيف وسيعود peekaboo إلى المضيفين الآخرين المتاحين.

ترتيب اكتشاف العميل

تحاول عملاء Peekaboo عادةً المضيفين بهذا الترتيب:

Peekaboo.app (تجربة مستخدم كاملة)
Claude.app (إذا كان مثبتًا)
OmeniaClaw.app (وسيط خفيف)

استخدم peekaboo bridge status --verbose لمعرفة المضيف النشط ومسار المقبس المستخدم. يمكنك التجاوز باستخدام:

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

الأمان والأذونات

يتحقق الجسر من تواقيع كود المستدعي؛ ويتم فرض قائمة سماح لـ TeamIDs (TeamID مضيف Peekaboo + TeamID تطبيق OmeniaClaw).
تنتهي مهلة الطلبات بعد نحو 10 ثوانٍ.
إذا كانت الأذونات المطلوبة مفقودة، يعيد الجسر رسالة خطأ واضحة بدلًا من تشغيل إعدادات النظام.

سلوك اللقطات (الأتمتة)

تُخزّن اللقطات في الذاكرة وتنتهي صلاحيتها تلقائيًا بعد نافذة قصيرة. إذا كنت تحتاج إلى احتفاظ أطول، فأعد الالتقاط من العميل.

استكشاف الأخطاء وإصلاحها

إذا أبلغ peekaboo أن "عميل الجسر غير مصرّح له"، فتأكد من أن العميل موقّع بشكل صحيح أو شغّل المضيف باستخدام PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 في وضع التصحيح فقط.
إذا لم يتم العثور على أي مضيفين، فافتح أحد تطبيقات المضيف (Peekaboo.app أو OmeniaClaw.app) وتأكد من منح الأذونات.