Peekaboo ब्रिज (macOS UI स्वचालन)¶

26. OpenClaw PeekabooBridge को एक लोकल, अनुमति‑सचेत UI ऑटोमेशन ब्रोक़र के रूप में होस्ट कर सकता है। 27. इससे peekaboo CLI macOS ऐप की TCC अनुमतियों का पुनः उपयोग करते हुए UI ऑटोमेशन चला सकता है।

यह क्या है (और क्या नहीं है)¶

• होस्ट: OpenClaw.app, PeekabooBridge होस्ट के रूप में कार्य कर सकता है।
• क्लाइंट: peekaboo CLI का उपयोग करें (कोई अलग openclaw ui ... सतह नहीं)।
• UI: विज़ुअल ओवरले Peekaboo.app में ही रहते हैं; OpenClaw एक पतला ब्रोकर होस्ट है।

ब्रिज सक्षम करें¶

macOS ऐप में:

• सेटिंग्स → Peekaboo Bridge सक्षम करें

28. सक्षम होने पर, OpenClaw एक लोकल UNIX सॉकेट सर्वर शुरू करता है। 29. यदि अक्षम है, तो होस्ट बंद कर दिया जाता है और peekaboo अन्य उपलब्ध होस्ट्स पर फ़ॉलबैक करेगा।

क्लाइंट डिस्कवरी क्रम¶

Peekaboo क्लाइंट सामान्यतः इस क्रम में होस्ट्स आज़माते हैं:

1. Peekaboo.app (पूर्ण UX)
2. Claude.app (यदि इंस्टॉल हो)
3. OpenClaw.app (पतला ब्रोकर)

30) कौन‑सा होस्ट सक्रिय है और कौन‑सा सॉकेट पाथ उपयोग में है, यह देखने के लिए peekaboo bridge status --verbose का उपयोग करें। 31. आप ओवरराइड कर सकते हैं:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

सुरक्षा और अनुमतियाँ¶

• ब्रिज कॉलर कोड सिग्नेचर को सत्यापित करता है; TeamIDs की एक अनुमति‑सूची लागू होती है (Peekaboo होस्ट TeamID + OpenClaw ऐप TeamID)।
• अनुरोध ~10 सेकंड के बाद टाइम‑आउट हो जाते हैं।
• यदि आवश्यक अनुमतियाँ अनुपस्थित हैं, तो ब्रिज System Settings लॉन्च करने के बजाय एक स्पष्ट त्रुटि संदेश लौटाता है।

स्नैपशॉट व्यवहार (स्वचालन)¶

32. स्नैपशॉट्स मेमोरी में स्टोर होते हैं और थोड़े समय बाद अपने‑आप एक्सपायर हो जाते हैं।
33. यदि आपको लंबी रिटेंशन चाहिए, तो क्लाइंट से दोबारा कैप्चर करें।

समस्या-निवारण¶

• यदि peekaboo “bridge client is not authorized” रिपोर्ट करता है, तो सुनिश्चित करें कि क्लाइंट सही तरीके से साइन किया गया है, या केवल debug मोड में PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 के साथ होस्ट चलाएँ।
• यदि कोई होस्ट नहीं मिलता है, तो होस्ट ऐप्स में से किसी एक (Peekaboo.app या OpenClaw.app) को खोलें और पुष्टि करें कि अनुमतियाँ प्रदान की गई हैं।