التطبيق المرافق لنظام macOS

جسر Peekaboo

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

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

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

تمكين الجسر

في تطبيق macOS:

  • الإعدادات → تمكين جسر Peekaboo

عند التمكين، يبدأ 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

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

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

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

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

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

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

المهارات