Peekaboo Bridge（macOS UI自動化）

OpenClawは、ローカルで権限を考慮したUI自動化ブローカーとして PeekabooBridge をホストできます。これにより、peekaboo CLIはmacOSアプリのTCC権限を再利用しながらUI自動化を操作できます。

これは何で、何ではないか

macOSアプリ内で:

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

Peekabooクライアントは通常、次の順序でホストを試します:

どのホストがアクティブで、どのソケットパスが使われているかを確認するには、peekaboo bridge status --verbose を使用してください。次のようにして上書きすることもできます:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

ブリッジは呼び出し元のコード署名を検証します。TeamIDのallowlist （PeekabooホストのTeamID + OpenClawアプリのTeamID）が適用されます。
リクエストは約10秒でタイムアウトします。
必要な権限が不足している場合、ブリッジはSystem Settingsを起動するのではなく、明確なエラーメッセージを返します。

スナップショットはメモリ内に保存され、短時間後に自動的に失効します。より長く保持したい場合は、クライアントから再取得してください。

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