Passer au contenu principal

​
Peekaboo Bridge (automatisation de l’UI macOS)

OpenClaw peut héberger PeekabooBridge en tant que courtier local d’automatisation de l’UI, conscient des autorisations. Cela permet à la CLI peekaboo de piloter l’automatisation de l’UI tout en réutilisant les autorisations TCC de l’app macOS.

​
Ce que c’est (et ce que ce n’est pas)

  • Hôte : OpenClaw.app peut agir comme hôte PeekabooBridge.
  • Client : utilisez la CLI peekaboo (pas de surface openclaw ui ... distincte).
  • UI : les superpositions visuelles restent dans Peekaboo.app ; OpenClaw est un hôte de courtage léger.

​
Activer le bridge

Dans l’app macOS :
  • Réglages → Enable Peekaboo Bridge
Lorsqu’il est activé, OpenClaw démarre un serveur de socket UNIX local. S’il est désactivé, l’hôte est arrêté et peekaboo se repliera sur d’autres hôtes disponibles.

​
Ordre de découverte côté client

Les clients Peekaboo essaient généralement les hôtes dans cet ordre :
  1. Peekaboo.app (UX complète)
  2. Claude.app (si installé)
  3. OpenClaw.app (courtier léger)
Utilisez peekaboo bridge status --verbose pour voir quel hôte est actif et quel chemin de socket est utilisé. Vous pouvez forcer avec : 
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

​
Sécurité et autorisations

  • Le bridge valide les signatures de code de l’appelant ; une liste d’autorisation de TeamIDs est appliquée (TeamID de l’hôte Peekaboo + TeamID de l’app OpenClaw).
  • Les requêtes expirent après ~10 secondes.
  • Si des autorisations requises manquent, le bridge renvoie un message d’erreur clair plutôt que de lancer Réglages Système.

​
Comportement des instantanés (automatisation)

Les instantanés sont stockés en mémoire et expirent automatiquement après une courte durée. Si vous avez besoin d’une conservation plus longue, recapturez depuis le client.

​
Problemes courants

  • Si peekaboo indique « bridge client is not authorized », assurez‑vous que le client est correctement signé ou exécutez l’hôte avec PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 en mode debug uniquement.
  • Si aucun hôte n’est trouvé, ouvrez l’une des apps hôtes (Peekaboo.app ou OpenClaw.app) et confirmez que les autorisations sont accordées.