macOS companion app
บริดจ์จ๊ะเอ๋
OpenClaw สามารถโฮสต์ PeekabooBridge เป็นโบรกเกอร์ระบบอัตโนมัติของ UI ภายในเครื่องที่รับรู้สิทธิ์ได้ ซึ่งทำให้ CLI peekaboo ขับเคลื่อนระบบอัตโนมัติของ UI ได้พร้อมกับใช้สิทธิ์ TCC ของแอป macOS ซ้ำ
สิ่งนี้คืออะไร (และไม่ใช่อะไร)
- โฮสต์: OpenClaw.app สามารถทำหน้าที่เป็นโฮสต์ของ PeekabooBridge ได้
- ไคลเอนต์: ใช้ CLI
peekaboo(ไม่มีพื้นผิวopenclaw ui ...แยกต่างหาก) - UI: โอเวอร์เลย์ภาพยังคงอยู่ใน Peekaboo.app; OpenClaw เป็นโฮสต์โบรกเกอร์แบบบาง
ความสัมพันธ์กับ Computer Use
OpenClaw มีเส้นทางควบคุมเดสก์ท็อปสามแบบ และตั้งใจให้แยกจากกัน:
- โฮสต์ PeekabooBridge: OpenClaw.app สามารถโฮสต์ซ็อกเก็ต PeekabooBridge ภายในเครื่องได้ CLI
peekabooยังคงเป็นไคลเอนต์และใช้สิทธิ์ macOS ของ OpenClaw.app สำหรับพื้นฐานระบบอัตโนมัติของ Peekaboo เช่น ภาพหน้าจอ การคลิก เมนู กล่องโต้ตอบ การทำงานกับ Dock และการจัดการหน้าต่าง - Codex Computer Use: Plugin
codexที่รวมมาเตรียม Codex app-server ตรวจสอบว่าเซิร์ฟเวอร์ MCPcomputer-useของ Codex พร้อมใช้งาน จากนั้นให้ Codex เป็นเจ้าของการเรียกเครื่องมือควบคุมเดสก์ท็อปแบบเนทีฟระหว่างเทิร์นในโหมด Codex OpenClaw ไม่พร็อกซีการทำงานเหล่านั้นผ่าน PeekabooBridge - MCP
cua-driverโดยตรง: OpenClaw สามารถลงทะเบียนเซิร์ฟเวอร์cua-driver mcpต้นทางของ TryCua เป็นเซิร์ฟเวอร์ MCP ปกติได้ ซึ่งให้อะเจนต์ใช้สคีมาและเวิร์กโฟลว์ pid/window/element-index ของไดรเวอร์ CUA เอง โดยไม่กำหนดเส้นทางผ่านตลาด Codex หรือซ็อกเก็ต PeekabooBridge
ใช้ Peekaboo เมื่อต้องการพื้นผิวระบบอัตโนมัติของ macOS ที่กว้างและโฮสต์บริดจ์ที่รับรู้สิทธิ์ของ OpenClaw.app ใช้ Codex Computer Use เมื่ออะเจนต์ในโหมด Codex ควรพึ่งพา Plugin computer-use แบบเนทีฟของ Codex ใช้ cua-driver mcp โดยตรงเมื่อต้องการให้ไดรเวอร์ CUA เปิดเผยต่อรันไทม์ที่ OpenClaw จัดการในฐานะเซิร์ฟเวอร์ MCP ปกติ
เปิดใช้บริดจ์
ในแอป macOS:
- การตั้งค่า → เปิดใช้ Peekaboo Bridge
เมื่อเปิดใช้ OpenClaw จะเริ่มเซิร์ฟเวอร์ซ็อกเก็ต UNIX ภายในเครื่อง หากปิดใช้ โฮสต์จะหยุดทำงานและ peekaboo จะย้อนกลับไปใช้โฮสต์อื่นที่มีอยู่
ลำดับการค้นพบของไคลเอนต์
โดยทั่วไปไคลเอนต์ Peekaboo จะลองโฮสต์ตามลำดับนี้:
- Peekaboo.app (UX เต็มรูปแบบ)
- Claude.app (หากติดตั้งไว้)
- OpenClaw.app (โบรกเกอร์แบบบาง)
ใช้ peekaboo bridge status --verbose เพื่อดูว่าโฮสต์ใดทำงานอยู่และกำลังใช้เส้นทางซ็อกเก็ตใด คุณสามารถแทนที่ได้ด้วย:
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock
ความปลอดภัยและสิทธิ์
- บริดจ์ตรวจสอบ ลายเซ็นโค้ดของผู้เรียก; มีการบังคับใช้รายการอนุญาตของ TeamID (TeamID ของโฮสต์ Peekaboo + TeamID ของแอป OpenClaw)
- คำขอจะหมดเวลาหลังจากประมาณ 10 วินาที
- หากขาดสิทธิ์ที่จำเป็น บริดจ์จะส่งคืนข้อความข้อผิดพลาดที่ชัดเจนแทนการเปิดการตั้งค่าระบบ
พฤติกรรมของสแนปชอต (ระบบอัตโนมัติ)
สแนปชอตจะถูกเก็บไว้ในหน่วยความจำและหมดอายุโดยอัตโนมัติหลังจากช่วงเวลาสั้น ๆ หากต้องการเก็บไว้นานขึ้น ให้จับภาพใหม่จากไคลเอนต์
การแก้ไขปัญหา
- หาก
peekabooรายงานว่า "bridge client is not authorized" ให้ตรวจสอบว่าไคลเอนต์ได้รับการลงนามอย่างถูกต้อง หรือเรียกใช้โฮสต์ด้วยPEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1ในโหมด ดีบัก เท่านั้น - หากไม่พบโฮสต์ ให้เปิดหนึ่งในแอปโฮสต์ (Peekaboo.app หรือ OpenClaw.app) และยืนยันว่าสิทธิ์ได้รับการอนุญาตแล้ว