Cầu nối Peekaboo

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

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

• Máy chủ: OpenClaw.app có thể hoạt động như một máy chủ PeekabooBridge.
• Máy khách: dùng CLI peekaboo (không có bề mặt openclaw ui ... riêng).
• UI: các lớp phủ trực quan vẫn nằm trong Peekaboo.app; OpenClaw là một máy chủ môi giới mỏng.

# Mối quan hệ với Computer Use

OpenClaw có ba đường dẫn điều khiển máy tính để bàn, và chúng được chủ ý giữ riêng biệt:

• Máy chủ PeekabooBridge: OpenClaw.app có thể lưu trữ socket PeekabooBridge cục bộ. CLI peekaboo vẫn là máy khách và dùng các quyền macOS của OpenClaw.app cho các nguyên hàm tự động hóa Peekaboo như ảnh chụp màn hình, nhấp chuột, menu, hộp thoại, thao tác Dock và quản lý cửa sổ.
• Codex Computer Use: Plugin codex đi kèm chuẩn bị máy chủ ứng dụng Codex, xác minh rằng máy chủ MCP computer-use của Codex có sẵn, rồi cho phép Codex sở hữu các lệnh gọi công cụ điều khiển máy tính để bàn gốc trong các lượt chế độ Codex. OpenClaw không proxy các thao tác đó qua PeekabooBridge.
• MCP cua-driver trực tiếp: OpenClaw có thể đăng ký máy chủ cua-driver mcp upstream của TryCua như một máy chủ MCP thông thường. Điều đó cung cấp cho agent các schema riêng của trình điều khiển CUA và quy trình pid/cửa sổ/chỉ mục phần tử mà không định tuyến qua marketplace của Codex hoặc socket PeekabooBridge.

Dùng Peekaboo khi bạn muốn bề mặt tự động hóa macOS rộng và máy chủ cầu nối nhận biết quyền của OpenClaw.app. Dùng Codex Computer Use khi một agent ở chế độ Codex nên dựa vào Plugin computer-use gốc của Codex. Dùng cua-driver mcp trực tiếp khi bạn muốn trình điều khiển CUA được cung cấp cho bất kỳ runtime nào do OpenClaw quản lý như một máy chủ MCP thông thường.

# Bật cầu nối

Trong ứng dụng macOS:

• Cài đặt → Bật Peekaboo Bridge

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

# Thứ tự khám phá máy khách

Các máy khách Peekaboo thường thử máy chủ theo thứ tự này:

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

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

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

# Bảo mật và quyền

• Cầu nối xác thực chữ ký mã của bên gọi; danh sách cho phép gồm các TeamID được thực thi (TeamID của máy chủ Peekaboo + TeamID của ứng dụng OpenClaw).
• Yêu cầu hết thời gian chờ sau khoảng 10 giây.
• Nếu thiếu quyền bắt buộc, cầu nối trả về một thông báo lỗi rõ ràng thay vì khởi chạy Cài đặt hệ thống.

# Hành vi snapshot (tự động hóa)

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 bạn cần giữ lâu hơn, hãy chụp lại từ máy khách.

# Khắc phục sự cố

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

# Liên quan

• Ứng dụng macOS
• Quyền macOS