Peekaboo Bridge (การทำอัตโนมัติ UI บน macOS)¶
OpenClaw สามารถโฮสต์ PeekabooBridge เป็นโบรกเกอร์การทำอัตโนมัติ UI แบบโลคัลที่คำนึงถึงสิทธิ์การอนุญาตได้ ซึ่งช่วยให้ peekaboo CLI ควบคุมการทำอัตโนมัติ UI ได้ โดยยังคงใช้สิทธิ์ TCC ของแอป macOS ร่วมกัน 24. สิ่งนี้ทำให้ CLI peekaboo ควบคุม UI automation ได้ ขณะเดียวกันก็ใช้สิทธิ์ TCC ของแอป macOS ซ้ำ
สิ่งนี้คืออะไร (และไม่ใช่อะไร)¶
- โฮสต์: OpenClaw.app สามารถทำหน้าที่เป็นโฮสต์ PeekabooBridge ได้
- ไคลเอนต์: ใช้
peekabooCLI (ไม่มีผิวการใช้งานopenclaw ui ...แยกต่างหาก) - UI: โอเวอร์เลย์แบบภาพยังคงอยู่ใน Peekaboo.app; OpenClaw เป็นโฮสต์โบรกเกอร์แบบบาง
เปิดใช้งานบริดจ์¶
ในแอป macOS:
- การตั้งค่า → Enable Peekaboo Bridge
- เมื่อเปิดใช้งาน OpenClaw จะเริ่มเซิร์ฟเวอร์ UNIX socket ภายในเครื่อง เมื่อเปิดใช้งาน OpenClaw จะเริ่มเซิร์ฟเวอร์ซ็อกเก็ต UNIX แบบโลคัล หากปิดใช้งาน โฮสต์จะถูกหยุดและ
peekabooจะถอยกลับไปใช้โฮสต์อื่นที่มีอยู่
ลำดับการค้นหาไคลเอนต์¶
โดยทั่วไปไคลเอนต์ Peekaboo จะพยายามค้นหาโฮสต์ตามลำดับนี้:
- Peekaboo.app (UX เต็มรูปแบบ)
- Claude.app (หากติดตั้ง)
- OpenClaw.app (โบรกเกอร์แบบบาง)
ใช้ peekaboo bridge status --verbose เพื่อดูว่าโฮสต์ใดกำลังทำงานอยู่และใช้พาธซ็อกเก็ตใด คุณสามารถบังคับแทนที่ได้ด้วย: 26. คุณสามารถโอเวอร์ไรด์ได้ด้วย:
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock
ความปลอดภัยและสิทธิ์การอนุญาต¶
- บริดจ์จะตรวจสอบ ลายเซ็นโค้ดของผู้เรียก และบังคับใช้รายการอนุญาตของ TeamID (TeamID ของโฮสต์ Peekaboo + TeamID ของแอป OpenClaw)
- คำขอจะหมดเวลาประมาณ ~10 วินาที
- หากขาดสิทธิ์ที่จำเป็น บริดจ์จะส่งข้อความข้อผิดพลาดที่ชัดเจน แทนการเปิด System Settings
พฤติกรรมสแนปช็อต (การทำอัตโนมัติ)¶
สแนปช็อตจะถูกเก็บไว้ในหน่วยความจำและหมดอายุอัตโนมัติหลังจากช่วงเวลาสั้นๆ หากต้องการเก็บไว้นานขึ้น ให้จับภาพใหม่จากฝั่งไคลเอนต์ 27. หากต้องการเก็บข้อมูลนานขึ้น ให้จับใหม่จากฝั่งไคลเอนต์
การแก้ไขปัญหา¶
- หาก
peekabooรายงานว่า “bridge client is not authorized” ให้ตรวจสอบว่าไคลเอนต์ถูกเซ็นอย่างถูกต้อง หรือรันโฮสต์ด้วยPEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1ในโหมด debug เท่านั้น - หากไม่พบโฮสต์ ให้เปิดแอปโฮสต์ใดแอปหนึ่ง (Peekaboo.app หรือ OpenClaw.app) และยืนยันว่าได้อนุญาตสิทธิ์แล้ว