Peekaboo Bridge (tự động hóa UI trên macOS)

OpenClaw có thể host PeekabooBridge như một broker tự động hóa UI cục bộ, có nhận biết quyền. Điều này cho phép peekaboo CLI điều khiển tự động hóa UI trong khi tái sử dụng quyền TCC của ứng dụng macOS.

Đây là gì (và không phải là gì)

  • Host: OpenClaw.app có thể hoạt động như một PeekabooBridge host.
  • Client: dùng peekaboo CLI (không có giao diện openclaw ui ... riêng).
  • UI: các overlay hiển thị vẫn nằm trong Peekaboo.app; OpenClaw chỉ là một broker host mỏng.

Bật bridge

Trong ứng dụng macOS:

  • Settings → Enable Peekaboo Bridge

Khi được bật, OpenClaw sẽ khởi động một UNIX socket server cục bộ. Nếu tắt, host sẽ dừng lại và peekaboo sẽ quay về các host khả dụng khác.

Thứ tự tìm kiếm client

Peekaboo client thường thử các host theo thứ tự này:

  1. Peekaboo.app (UX đầy đủ)
  2. Claude.app (nếu đã cài)
  3. OpenClaw.app (broker mỏng)

Dùng peekaboo bridge status --verbose để xem host nào đang hoạt động và đường dẫn socket nào đang được dùng. Các bạn có thể ghi đè bằng:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Bảo mật & quyền

  • Bridge xác thực chữ ký code của caller; một allowlist các TeamID được áp dụng (Peekaboo host TeamID + OpenClaw app TeamID).
  • Request sẽ timeout sau khoảng 10 giây.
  • Nếu thiếu quyền cần thiết, bridge sẽ trả về thông báo lỗi rõ ràng thay vì mở System Settings.

Hành vi snapshot (automation)

Snapshot được lưu trong bộ nhớ và tự động hết hạn sau một khoảng thời gian ngắn. Nếu các bạn cần giữ lâu hơn, hãy chụp lại từ client.

Troubleshooting

  • Nếu peekaboo báo “bridge client is not authorized”, hãy đảm bảo client được ký đúng cách hoặc chạy host với PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 chỉ trong chế độ debug.
  • Nếu không tìm thấy host nào, hãy mở một trong các ứng dụng host (Peekaboo.app hoặc OpenClaw.app) và xác nhận quyền đã được cấp.