English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

macOS companion app

Peekaboo ブリッジ

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

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

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

Computer Use との関係

OpenClaw には 3 つのデスクトップ制御パスがあり、それらは意図的に分離されています。

  • PeekabooBridge ホスト: OpenClaw.app はローカルの PeekabooBridge ソケットをホストできます。 peekaboo CLI は引き続きクライアントであり、スクリーンショット、クリック、メニュー、ダイアログ、Dock アクション、ウィンドウ管理などの Peekaboo オートメーションプリミティブに OpenClaw.app の macOS 権限を使用します。
  • Codex Computer Use: バンドルされた codex Plugin は Codex アプリサーバーを準備し、Codex の computer-use MCP サーバーが利用可能であることを検証してから、Codex モードのターン中に Codex がネイティブのデスクトップ制御ツール呼び出しを所有できるようにします。OpenClaw はこれらのアクションを PeekabooBridge 経由でプロキシしません。
  • 直接の cua-driver MCP: OpenClaw は TryCua のアップストリーム cua-driver mcp サーバーを通常の MCP サーバーとして登録できます。これにより、Codex マーケットプレイスや PeekabooBridge ソケットを経由せずに、エージェントは CUA ドライバー独自のスキーマと pid/window/element-index ワークフローを利用できます。

広範な macOS オートメーションサーフェスと、OpenClaw.app の権限を考慮したブリッジホストが必要な場合は Peekaboo を使用します。Codex モードのエージェントが Codex のネイティブ computer-use Plugin に依存するべき場合は Codex Computer Use を使用します。CUA ドライバーを通常の MCP サーバーとして任意の OpenClaw 管理ランタイムに公開したい場合は、直接の cua-driver mcp を使用します。

ブリッジを有効化する

macOS アプリで:

  • 設定 → Peekaboo Bridge を有効化

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

クライアントの検出順序

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

  1. Peekaboo.app（完全な UX）
  2. Claude.app（インストール済みの場合）
  3. OpenClaw.app（薄いブローカー）

どのホストがアクティブで、どのソケットパスが使用中かを確認するには、peekaboo bridge status --verbose を使用します。次のように上書きできます。

bash
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

セキュリティと権限

  • ブリッジは 呼び出し元のコード署名 を検証します。TeamID の許可リストが適用されます（Peekaboo ホスト TeamID + OpenClaw アプリ TeamID）。
  • Accessibility には、汎用的な node ランタイムよりも署名済みのブリッジ/アプリ ID を優先してください。node に Accessibility を付与すると、その Node 実行ファイルによって起動された任意のパッケージが GUI オートメーションアクセスを継承できます。詳しくは macOS 権限 を参照してください。
  • リクエストは約 10 秒後にタイムアウトします。
  • 必要な権限が不足している場合、ブリッジは System Settings を起動するのではなく、明確なエラーメッセージを返します。

スナップショットの動作（オートメーション）

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

トラブルシューティング

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

関連

Was this useful?
On this page

On this page