Przejdź do głównej treści

Documentation Index

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

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

OpenClaw może hostować PeekabooBridge jako lokalnego, świadomego uprawnień brokera automatyzacji UI. Dzięki temu CLI peekaboo może sterować automatyzacją UI, ponownie wykorzystując uprawnienia TCC aplikacji macOS.

​
Czym to jest (a czym nie jest)

  • Host: OpenClaw.app może działać jako host PeekabooBridge.
  • Klient: użyj CLI peekaboo (bez osobnej powierzchni openclaw ui ...).
  • UI: wizualne nakładki pozostają w Peekaboo.app; OpenClaw jest lekkim hostem brokera.

​
Relacja do Computer Use

OpenClaw ma trzy ścieżki sterowania pulpitem i celowo pozostają one oddzielne:
  • Host PeekabooBridge: OpenClaw.app może hostować lokalny socket PeekabooBridge. CLI peekaboo pozostaje klientem i używa uprawnień macOS aplikacji OpenClaw.app dla prymitywów automatyzacji Peekaboo, takich jak zrzuty ekranu, kliknięcia, menu, okna dialogowe, akcje Docka i zarządzanie oknami.
  • Codex Computer Use: dołączony Plugin codex przygotowuje serwer aplikacji Codex, weryfikuje, że serwer MCP computer-use Codex jest dostępny, a następnie pozwala Codex przejąć natywne wywołania narzędzi sterowania pulpitem podczas tur w trybie Codex. OpenClaw nie pośredniczy w tych akcjach przez PeekabooBridge.
  • Bezpośredni MCP cua-driver: OpenClaw może zarejestrować nadrzędny serwer cua-driver mcp TryCua jako zwykły serwer MCP. Daje to agentom własne schematy sterownika CUA oraz przepływ pracy pid/okno/indeks-elementu bez routingu przez marketplace Codex ani socket PeekabooBridge.
Użyj Peekaboo, gdy chcesz mieć szeroką powierzchnię automatyzacji macOS oraz świadomy uprawnień host mostu OpenClaw.app. Użyj Codex Computer Use, gdy agent w trybie Codex powinien polegać na natywnym Plugin do computer-use Codex. Użyj bezpośredniego cua-driver mcp, gdy chcesz udostępnić sterownik CUA dowolnemu środowisku uruchomieniowemu zarządzanemu przez OpenClaw jako zwykły serwer MCP.

​
Włącz most

W aplikacji macOS:
  • Ustawienia → Włącz Peekaboo Bridge
Po włączeniu OpenClaw uruchamia lokalny serwer socketu UNIX. Jeśli jest wyłączony, host zostaje zatrzymany, a peekaboo przełączy się na inne dostępne hosty.

​
Kolejność wykrywania klienta

Klienci Peekaboo zwykle próbują hostów w tej kolejności:
  1. Peekaboo.app (pełny UX)
  2. Claude.app (jeśli zainstalowana)
  3. OpenClaw.app (lekki broker)
Użyj peekaboo bridge status --verbose, aby zobaczyć, który host jest aktywny i która ścieżka socketu jest używana. Możesz nadpisać to za pomocą: 
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

​
Bezpieczeństwo i uprawnienia

  • Most weryfikuje podpisy kodu wywołującego; wymuszana jest lista dozwolonych TeamID (TeamID hosta Peekaboo + TeamID aplikacji OpenClaw).
  • Żądania wygasają po około 10 sekundach.
  • Jeśli brakuje wymaganych uprawnień, most zwraca jasny komunikat o błędzie zamiast uruchamiać Ustawienia systemowe.

​
Zachowanie migawek (automatyzacja)

Migawki są przechowywane w pamięci i wygasają automatycznie po krótkim czasie. Jeśli potrzebujesz dłuższego przechowywania, przechwyć je ponownie z klienta.

​
Rozwiązywanie problemów

  • Jeśli peekaboo zgłasza „bridge client is not authorized”, upewnij się, że klient jest prawidłowo podpisany, albo uruchom host z PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 wyłącznie w trybie debug.
  • Jeśli nie znaleziono żadnych hostów, otwórz jedną z aplikacji hosta (Peekaboo.app lub OpenClaw.app) i potwierdź, że uprawnienia zostały przyznane.

​
Powiązane