Peekaboo Bridge（macOS UI自動化）

OpenClawはPeekabooBridgeをローカルのパーミッション対応UI自動化ブローカーとしてホストできます。これにより、peekaboo CLIがmacOSアプリのTCCパーミッションを再利用してUI自動化を実行できます。

これは何か（何でないか）

ホスト：OpenClaw.appがPeekabooBridgeホストとして機能可能。
クライアント：peekaboo CLIを使用（openclaw ui ...という別サーフェスはなし）。
UI：ビジュアルオーバーレイはPeekaboo.appに残る。OpenClawは薄いブローカーホスト。

ブリッジの有効化

macOSアプリで：

設定 → Enable Peekaboo Bridge

有効にするとOpenClawがローカルUNIXソケットサーバーを起動します。無効にするとホストが停止し、peekabooは他の利用可能なホストにフォールバックします。

クライアントの検出順序

Peekabooクライアントは通常以下の順序でホストを試みます：

Peekaboo.app（フルUX）
Claude.app（インストールされている場合）
OpenClaw.app（薄いブローカー）

peekaboo bridge status --verboseでアクティブなホストと使用中のソケットパスを確認できます。オーバーライドするには：

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

セキュリティとパーミッション

ブリッジは呼び出し元のコード署名を検証。TeamIDの許可リストが適用されます（Peekabooホスト TeamID + OpenClawアプリTeamID）。
リクエストは約10秒後にタイムアウト。
必要なパーミッションが不足している場合、ブリッジはシステム設定を起動する代わりに明確なエラーメッセージを返します。

スナップショットの動作（自動化）

スナップショットはメモリに保存され、短い期間後に自動的に期限切れになります。長時間の保持が必要な場合は、クライアントから再キャプチャしてください。

トラブルシューティング

peekabooが「bridge client is not authorized」と報告する場合：クライアントが正しく署名されていることを確認するか、デバッグモードのみでPEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1を設定してホストを実行してください。
ホストが見つからない場合：ホストアプリ（Peekaboo.appまたはOpenClaw.app）を開き、パーミッションが付与されていることを確認してください。