Most Peekaboo

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

• aplikacja macOS
• uprawnienia macOS