> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Peekaboo Bridge

> OpenClaw は、ローカルで動作する権限認識型の UI 自動化 broker として PeekabooBridge をホストできます。これにより、peekaboo CLI は macOS アプリ側の TCC 権限を再利用しながら UI 自動化を実行できます。

OpenClaw は、ローカルで動作する権限認識型の UI 自動化 broker として **PeekabooBridge** をホストできます。これにより、`peekaboo` CLI は macOS アプリ側の TCC 権限を再利用しながら UI 自動化を実行できます。

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

* **Host**: OpenClaw\.app は PeekabooBridge のホストになれます。
* **Client**: 利用するのは `peekaboo` CLI であり、別個の `openclaw ui ...` インターフェースはありません。
* **UI**: 可視オーバーレイは Peekaboo.app 側に残り、OpenClaw は薄い broker host として振る舞います。

## ブリッジを有効にする

macOS アプリで次を有効にします。

* Settings → **Enable Peekaboo Bridge**

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

## クライアントの検出順序

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

1. Peekaboo.app（完全な UX を提供）
2. Claude.app（インストールされている場合）
3. OpenClaw\.app（薄い broker）

どのホストがアクティブで、どのソケット パスが使われているかは `peekaboo bridge status --verbose` で確認できます。必要に応じて、次の環境変数で上書きできます。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock
```

## セキュリティと権限

* ブリッジは **呼び出し元のコード署名** を検証します。許可される Team ID の allowlist を強制し、Peekaboo host の Team ID と OpenClaw app の Team ID を受け付けます。
* リクエストはおよそ 10 秒でタイムアウトします。
* 必要な権限が不足している場合、System Settings を勝手に開くのではなく、明確なエラー メッセージを返します。

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

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

## トラブルシューティング

* `peekaboo` が `bridge client is not authorized` と報告する場合は、クライアントが正しく署名されているか確認してください。`PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1` を使うのは **debug** モード限定にしてください。
* ホストが見つからない場合は、Peekaboo.app または OpenClaw\.app を起動し、必要な権限が付与済みか確認してください。