macOS companion app

पीकाबू ब्रिज

OpenClaw PeekabooBridge को स्थानीय, अनुमति-जागरूक UI स्वचालन ब्रोकर के रूप में होस्ट कर सकता है (PeekabooBridgeHostCoordinator, जो steipete/Peekaboo Swift पैकेज द्वारा समर्थित है)। इससे peekaboo CLI, macOS ऐप की TCC अनुमतियों का पुनः उपयोग करते हुए UI स्वचालन चला सकता है।

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

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

अन्य डेस्कटॉप-नियंत्रण मार्गों से संबंध

OpenClaw में डेस्कटॉप नियंत्रण के चार मार्ग हैं, जिन्हें जानबूझकर अलग रखा गया है:

PeekabooBridge होस्ट: OpenClaw.app स्थानीय PeekabooBridge सॉकेट को होस्ट करता है। peekaboo CLI क्लाइंट है और स्क्रीनशॉट, क्लिक, मेनू, संवाद, Dock कार्रवाइयों तथा विंडो प्रबंधन के लिए OpenClaw.app की macOS अनुमतियों का उपयोग करता है।
एजेंट-संचालित कंप्यूटर उपयोग (computer.act): Gateway एजेंट का अंतर्निहित computer टूल, screen.snapshot के माध्यम से स्क्रीनशॉट कैप्चर करता है और खतरनाक computer.act Node कमांड के जरिए पॉइंटर तथा कीबोर्ड चलाता है। macOS Node, PeekabooBridge सॉकेट या peekaboo CLI से गुजरे बिना, इस ब्रिज द्वारा उपलब्ध कराई गई एम्बेडेड Peekaboo स्वचालन सेवाओं और सीमित CoreGraphics प्रिमिटिव का उपयोग करके computer.act को प्रक्रिया के भीतर पूरा करता है। कंप्यूटर उपयोग देखें।
Codex कंप्यूटर उपयोग: बंडल किया गया codex Plugin, Codex के computer-use MCP Plugin (extensions/codex/src/app-server/computer-use.ts) की जाँच करता है और उसे इंस्टॉल कर सकता है, फिर Codex-मोड टर्न के दौरान Codex को मूल डेस्कटॉप-नियंत्रण टूल कॉल का स्वामित्व देता है। OpenClaw उन कार्रवाइयों को PeekabooBridge के माध्यम से प्रॉक्सी नहीं करता।
प्रत्यक्ष cua-driver MCP: OpenClaw, TryCua के अपस्ट्रीम cua-driver mcp सर्वर को सामान्य MCP सर्वर के रूप में पंजीकृत कर सकता है, जिससे एजेंटों को Codex मार्केटप्लेस या PeekabooBridge सॉकेट के माध्यम से रूट किए बिना CUA ड्राइवर की अपनी स्कीमा और pid/window/element-index कार्यप्रवाह मिलता है।

OpenClaw.app के अनुमति-जागरूक ब्रिज होस्ट के माध्यम से व्यापक macOS स्वचालन सतह के लिए Peekaboo का उपयोग करें। जब Gateway एजेंट को एक समान computer.act Node कमांड के माध्यम से डेस्कटॉप देखना और नियंत्रित करना हो, जिसे कोई भी विज़न मॉडल चला सके, तब एजेंट-संचालित कंप्यूटर उपयोग का इस्तेमाल करें। जब Codex-मोड एजेंट को Codex के मूल Plugin पर निर्भर रहना हो, तब Codex कंप्यूटर उपयोग का इस्तेमाल करें। किसी भी OpenClaw-प्रबंधित रनटाइम के लिए CUA ड्राइवर को सामान्य MCP सर्वर के रूप में उपलब्ध कराने हेतु प्रत्यक्ष cua-driver mcp का उपयोग करें।

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

macOS ऐप में: Settings -> Enable Peekaboo Bridge। इस टॉगल के लिए Allow Computer Control चालू होना आवश्यक है, क्योंकि दोनों स्थानीय UI स्वचालन की अनुमति देते हैं; Computer Control बंद होने पर टॉगल अक्षम रहता है और होस्ट नहीं चलता। Computer Control के बिना Peekaboo चलाने के लिए, इसके बजाय Peekaboo के अपने Mac ऐप को होस्ट के रूप में चलाएँ।

सक्षम होने पर (और Computer Control चालू होने पर), OpenClaw ~/Library/Application Support/OpenClaw/<socket-name> पर एक स्थानीय UNIX सॉकेट सर्वर शुरू करता है। अक्षम होने पर, होस्ट रुक जाता है और peekaboo अन्य उपलब्ध होस्ट पर फ़ॉलबैक करता है। समन्वयक पुराने peekaboo इंस्टॉलेशन के लिए वर्तमान सॉकेट की ओर संकेत करने वाले विरासत सॉकेट सिमलिंक (clawdbot, clawdis, Application Support के अंतर्गत moltbot) भी बनाए रखता है।

क्लाइंट खोज क्रम

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

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

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

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

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

ब्रिज कॉलर कोड हस्ताक्षरों को सत्यापित करता है; TeamIDs की अनुमत सूची लागू की जाती है (Peekaboo होस्ट TeamID और चल रहे ऐप का अपना TeamID)।
Accessibility के लिए सामान्य node रनटाइम के बजाय हस्ताक्षरित ब्रिज/ऐप पहचान को प्राथमिकता दें। node को Accessibility देने से उस Node एक्ज़ीक्यूटेबल द्वारा शुरू किया गया कोई भी पैकेज GUI स्वचालन पहुँच प्राप्त कर सकता है; macOS अनुमतियाँ देखें।
अनुरोध 10 सेकंड (requestTimeoutSec: 10) के बाद टाइम आउट हो जाते हैं।
यदि आवश्यक अनुमतियाँ मौजूद नहीं हैं, तो ब्रिज System Settings खोलने के बजाय एक स्पष्ट त्रुटि संदेश लौटाता है।

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

स्नैपशॉट 10-मिनट की वैधता अवधि और 50 स्नैपशॉट की सीमा (InMemorySnapshotManager) के साथ मेमोरी में संग्रहीत किए जाते हैं; क्लीनअप के दौरान आर्टिफ़ैक्ट नहीं हटाए जाते। यदि आपको अधिक समय तक प्रतिधारण चाहिए, तो क्लाइंट से दोबारा कैप्चर करें।

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

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