Peekaboo Bridge (macOS‑UI‑automatisering)¶

OpenClaw kan vara värd för PeekabooBridge som en lokal, behörighetsmedveten UI-automatisering mäklare. Detta låter peekaboo CLI-enhet UI automation när du återanvänder macOS appens TCC behörigheter.

Vad detta är (och inte är)¶

• Värd: OpenClaw.app kan fungera som värd för PeekabooBridge.
• Klient: använd peekaboo‑CLI:t (ingen separat openclaw ui ...‑yta).
• UI: visuella överlägg ligger kvar i Peekaboo.app; OpenClaw är en tunn mäklarvärd.

Aktivera bryggan¶

I macOS‑appen:

• Inställningar → Aktivera Peekaboo Bridge

När den är aktiverad startar OpenClaw en lokal UNIX-uttagsserver. Om inaktiverad stoppas värden och peekaboo kommer att falla tillbaka till andra tillgängliga värdar.

Klienternas upptäcktsordning¶

Peekaboo‑klienter provar vanligtvis värdar i denna ordning:

1. Peekaboo.app (full UX)
2. Claude.app (om installerad)
3. OpenClaw.app (tunn mäklare)

Använd peekaboo bridge status --verbose för att se vilken värd som är aktiv och vilken socket-sökväg som används. Du kan åsidosätta med:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Säkerhet och behörigheter¶

• Bryggan validerar anroparens kodsignaturer; en tillåtelselista med TeamID:n tillämpas (Peekaboo‑värdens TeamID + OpenClaw‑appens TeamID).
• Förfrågningar får timeout efter ~10 sekunder.
• Om nödvändiga behörigheter saknas returnerar bryggan ett tydligt felmeddelande i stället för att starta Systeminställningar.

Snapshot‑beteende (automatisering)¶

Ögonblicksbilder lagras i minnet och upphör automatiskt efter ett kort fönster. Om du behöver längre retention, återfånga från klienten.

Felsökning¶

• Om peekaboo rapporterar ”bridge client is not authorized”, säkerställ att klienten är korrekt signerad eller kör värden med PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 i debug‑läge endast.
• Om inga värdar hittas, öppna en av värdapparna (Peekaboo.app eller OpenClaw.app) och bekräfta att behörigheter är beviljade.