macOS companion app

Passerelle Peekaboo

OpenClaw peut héberger PeekabooBridge comme courtier local d’automatisation de l’interface utilisateur, sensible aux autorisations. Cela permet à la CLI peekaboo de piloter l’automatisation de l’interface utilisateur tout en réutilisant les autorisations TCC de l’application 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 ... séparée).
Interface utilisateur : les superpositions visuelles restent dans Peekaboo.app ; OpenClaw est un hôte courtier léger.

Relation avec Computer Use

OpenClaw dispose de trois voies de contrôle du bureau, et elles restent volontairement séparées :

Hôte PeekabooBridge : OpenClaw.app peut héberger le socket PeekabooBridge local. La CLI peekaboo reste le client et utilise les autorisations macOS d’OpenClaw.app pour les primitives d’automatisation Peekaboo, telles que les captures d’écran, les clics, les menus, les boîtes de dialogue, les actions Dock et la gestion des fenêtres.
Codex Computer Use : le plugin codex intégré prépare le serveur d’application Codex, vérifie que le serveur MCP computer-use de Codex est disponible, puis laisse Codex gérer les appels d’outils natifs de contrôle du bureau pendant les tours en mode Codex. OpenClaw ne relaie pas ces actions via PeekabooBridge.
MCP cua-driver direct : OpenClaw peut enregistrer le serveur cua-driver mcp amont de TryCua comme serveur MCP normal. Cela fournit aux agents les propres schémas du pilote CUA et son flux de travail pid/fenêtre/index d’élément, sans routage via la marketplace Codex ni le socket PeekabooBridge.

Utilisez Peekaboo lorsque vous souhaitez disposer de la large surface d’automatisation macOS et de l’hôte de pont sensible aux autorisations d’OpenClaw.app. Utilisez Codex Computer Use lorsqu’un agent en mode Codex doit s’appuyer sur le plugin natif computer-use de Codex. Utilisez directement cua-driver mcp lorsque vous souhaitez exposer le pilote CUA à tout runtime géré par OpenClaw comme serveur MCP normal.

Activer le pont

Dans l’application macOS :

Réglages → Activer Peekaboo Bridge

Lorsque cette option est activée, OpenClaw démarre un serveur de socket UNIX local. Si elle est désactivée, l’hôte est arrêté et peekaboo se rabattra sur les autres hôtes disponibles.

Ordre de découverte du client

Les clients Peekaboo essaient généralement les hôtes dans cet ordre :

Peekaboo.app (expérience utilisateur complète)
Claude.app (si installée)
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 le remplacer avec :

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Sécurité et autorisations

Le pont valide les signatures de code des appelants ; une liste d’autorisation de TeamID est appliquée (TeamID de l’hôte Peekaboo + TeamID de l’application OpenClaw).
Préférez l’identité de pont/application signée à un runtime node générique pour l’accessibilité. Accorder l’accessibilité à node permet à tout package lancé par cet exécutable Node d’hériter de l’accès à l’automatisation de l’interface graphique ; voir autorisations macOS.
Les requêtes expirent après environ 10 secondes.
Si les autorisations requises sont manquantes, le pont renvoie un message d’erreur clair au lieu 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 fenêtre. Si vous avez besoin d’une conservation plus longue, capturez-les à nouveau depuis le client.

Dépannage

Si peekaboo signale « 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 débogage uniquement.
Si aucun hôte n’est trouvé, ouvrez l’une des applications hôtes (Peekaboo.app ou OpenClaw.app) et confirmez que les autorisations sont accordées.

Connexe

Was this useful?