Peekaboo Bridge
PeekabooBridge integration for macOS UI automation
OpenClaw は PeekabooBridge をローカル、権限対応の UI 自動化として
ホストできます。これにより ''peekaboo'' CLI が UI 自動化を駆動し、
macOS アプリの TCC 権限を再利用できます。
これが何であるか（そして何でないか）
- ホスト：OpenClaw.app は PeekabooBridge ホストとして機能できます。
- ''クライアント''：''peekaboo'' CLI を使用します（個別の ''openclaw ui ...'' サーフェスはありません）。
- UI：ビジュアルオーバーレイは Peekaboo.app に残ります。OpenClaw は薄いブローカーホストです。
ブリッジを有効にする
macOS アプリで：
- 設定 → Peekaboo Bridge を有効にする
有効にすると、OpenClaw はローカル UNIX ソケットサーバーを起動します。無効にすると、ホストは
停止し、''peekaboo'' は他の利用可能なホストにフォールバックします。
クライアント発見順序
Peekaboo クライアントは通常、この順序でホストを試します：
1. Peekaboo.app（完全な UX）
2. Claude.app（インストールされている場合）
3. 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" と報告する場合、クライアントが
properly signed or run the host with ''PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1''
デバッグ モードでのみ。
- ホストが見つからない場合は、ホストアプリのいずれか（Peekaboo.app または OpenClaw.app）を開き、
権限が付与されていることを確認してください。