Peekaboo Bridge (macOS UI آٹومیشن)¶

OpenClaw PeekabooBridge کو ایک لوکل، اجازت‑آگاہ UI آٹومیشن بروکر کے طور پر ہوسٹ کر سکتا ہے۔ اس سے peekaboo CLI کو UI آٹومیشن چلانے کی اجازت ملتی ہے جبکہ macOS ایپ کی TCC اجازتوں کو دوبارہ استعمال کیا جاتا ہے۔

یہ کیا ہے (اور کیا نہیں)¶

• Host: OpenClaw.app ایک PeekabooBridge ہوسٹ کے طور پر کام کر سکتا ہے۔
• Client: peekaboo CLI استعمال کریں (کوئی علیحدہ openclaw ui ... سطح نہیں)۔
• UI: بصری اوورلیز Peekaboo.app میں رہتی ہیں؛ OpenClaw ایک ہلکا بروکر ہوسٹ ہے۔

برج فعال کریں¶

macOS ایپ میں:

• ترتیبات → پیکابو برج کو فعال کریں

فعال ہونے پر، OpenClaw ایک لوکل UNIX ساکٹ سرور شروع کرتا ہے۔ If disabled, the host is stopped and peekaboo will fall back to other available hosts.

کلائنٹ ڈسکوری کی ترتیب¶

Peekaboo کلائنٹس عموماً اس ترتیب سے ہوسٹس آزماتے ہیں:

1. Peekaboo.app (مکمل UX)
2. Claude.app (اگر انسٹال ہو)
3. OpenClaw.app (ہلکا بروکر)

peekaboo bridge status --verbose استعمال کریں تاکہ معلوم ہو سکے کون سا ہوسٹ فعال ہے اور کون سا ساکٹ پاتھ استعمال میں ہے۔ You can override with:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

سکیورٹی اور اجازتیں¶

• برج کالر کوڈ دستخط کی توثیق کرتا ہے؛ TeamIDs کی اجازت فہرست نافذ کی جاتی ہے (Peekaboo ہوسٹ TeamID + OpenClaw ایپ TeamID)۔
• درخواستیں تقریباً 10 سیکنڈ بعد ٹائم آؤٹ ہو جاتی ہیں۔
• اگر مطلوبہ اجازتیں موجود نہ ہوں، تو برج System Settings لانچ کرنے کے بجائے واضح خرابی کا پیغام واپس کرتا ہے۔

اسنیپ شاٹ رویّہ (آٹومیشن)¶

اسنیپ شاٹس میموری میں محفوظ ہوتے ہیں اور ایک مختصر مدت کے بعد خود بخود ختم ہو جاتے ہیں۔ اگر آپ کو زیادہ دیر تک رکھنے کی ضرورت ہو تو کلائنٹ سے دوبارہ کیپچر کریں۔

خرابیوں کا ازالہ¶

• اگر peekaboo “bridge client is not authorized” رپورٹ کرے، تو یقینی بنائیں کہ کلائنٹ درست طور پر سائن کیا گیا ہے یا ہوسٹ کو PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 کے ساتھ صرف debug موڈ میں چلائیں۔
• اگر کوئی ہوسٹس نہ ملیں، تو ہوسٹ ایپس میں سے کسی ایک (Peekaboo.app یا OpenClaw.app) کو کھولیں اور تصدیق کریں کہ اجازتیں دی گئی ہیں۔