Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw có thể lưu trữ PeekabooBridge như một broker 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 đồng thời tái sử dụng các quyền TCC của ứng dụng macOS.

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

  • Máy chủ: OpenClaw.app có thể hoạt động như 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ủ broker mỏng.

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

OpenClaw có ba đường điều khiển desktop, và chúng được cố ý giữ tách 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 primitive 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 khả dụng, rồi cho phép Codex sở hữu các lệnh gọi công cụ điều khiển desktop gốc trong các lượt ở chế độ Codex. OpenClaw không proxy các hành động đó 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 các agent schema riêng của CUA driver cùng quy trình pid/cửa sổ/chỉ mục phần tử mà không định tuyến qua marketplace 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ủ bridge 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 CUA driver được phơi bày 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 bridge

Trong ứng dụng macOS:
  • Settings → 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ẽ fallback sang 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 (broker 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 & quyền

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

​
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ế độ debug.
  • 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 rằng các quyền đã được cấp.

​
Liên quan