メインコンテンツへスキップ

​
Peekaboo Bridge（macOS UI 自動化）

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

​
これは何か（そして何ではないか）

  • ホスト: OpenClaw.app は PeekabooBridge のホストとして動作できます。
  • クライアント: peekaboo CLI を使用します（別途 openclaw ui ... の UI はありません）。
  • UI: 視覚的なオーバーレイは Peekaboo.app に残り、OpenClaw は薄いブローカーホストです。

​
ブリッジを有効にする

macOS アプリで次を実行します。
  • 設定 → Enable Peekaboo Bridge
有効にすると、OpenClaw はローカルの UNIX ソケットサーバーを起動します。無効の場合、ホストは停止し、peekaboo は他の利用可能なホストにフォールバックします。 無効にすると、ホスト が停止し、peekaboo は他の利用可能なホストに戻ります。 無効にすると、ホスト が停止し、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」と報告する場合、クライアントが適切に署名されていることを確認するか、デバッグ モードのみで PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 を指定してホストを実行してください。
  • ホストが見つからない場合は、ホストアプリ（Peekaboo.app または OpenClaw.app）のいずれかを開き、権限が付与されていることを確認してください。