Passerelle coucou

OpenClaw peut héberger PeekabooBridge comme courtier local d’automatisation d’interface utilisateur tenant compte des 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 ... distincte).
• Interface utilisateur : les superpositions visuelles restent dans Peekaboo.app ; OpenClaw est un hôte courtier léger.

# Relation avec l’utilisation de l’ordinateur

OpenClaw dispose de trois chemins de contrôle du bureau, et ils restent volontairement séparés :

• 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 du Dock et la gestion des fenêtres.
• Utilisation de l’ordinateur par Codex : 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 prendre en charge 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 donne aux agents les schémas propres au pilote CUA et le flux de travail pid/fenêtre/index-d’élément sans passer par la place de marché Codex ni par le socket PeekabooBridge.

Utilisez Peekaboo lorsque vous voulez la vaste surface d’automatisation macOS et l’hôte de pont tenant compte des autorisations d’OpenClaw.app. Utilisez l’utilisation de l’ordinateur par Codex lorsqu’un agent en mode Codex doit s’appuyer sur le Plugin natif computer-use de Codex. Utilisez directement cua-driver mcp lorsque vous voulez exposer le pilote CUA à n’importe quel environnement d’exécution 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 :

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

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 TeamIDs est appliquée (TeamID de l’hôte Peekaboo + TeamID de l’application OpenClaw).
• Les requêtes expirent après environ 10 secondes.
• Si les autorisations requises sont absentes, 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 période. Si vous avez besoin d’une conservation plus longue, effectuez une nouvelle capture 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 debug 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.

# Associés

• application macOS
• autorisations macOS