Peekaboo は何をしますか？
Peekabooを使用してmacOS UIを検査し、目的のターゲットに対して操作を行い、結果を検証します。
以下の例はv4構文を使用しています。peekaboo --versionおよびインストール済みコマンドの--helpを確認してください。古いバージョンの場合は、そのバージョンのヘルプに従ってください。
OpenClaw Bridge
OpenClaw macOSアプリは、Computer Controlが有効で、そのプロバイダーがPeekabooであり、Peekaboo Bridgeが有効な場合にPeekaboo Bridgeをホストします。そのホスト経由で実行する場合は、既存のOpenClawソケット選択を維持してください。
export PEEKABOO_BRIDGE_SOCKET="${PEEKABOO_BRIDGE_SOCKET:-$HOME/Library/Application Support/OpenClaw/bridge.sock}"
peekaboo bridge status --json
選択したホストとソケットが意図したものであることを確認してください。明示的なPEEKABOO_BRIDGE_SOCKETまたは--bridge-socketの選択は維持してください。必要なホストが利用できない場合はその結果を報告し、コマンドを成功させるために選択をクリアしたりComputer Controlプロバイダーを切り替えたりしないでください。
権限は、操作を実行するプロセスまたはBridgeホストに属します。呼び出し元が必要な権限を持っていない限り、--no-remoteを渡さないでください。
インストール済みコマンドの確認
フラグやターゲット要件については、コマンド間でフラグをコピーするのではなく、各リーフコマンドのヘルプを使用してください。利用可能なコマンドを知るにはルートヘルプを使用します。
peekaboo --help
peekaboo app list --help
peekaboo see --help
peekaboo press --help
peekaboo drag --help
V4では以下の古いコマンドルートが削除されました。
| 古いコマンド | V4のコマンド |
|---|---|
list apps | app list |
image | see --no-elements（要素検出なしのピクセル取得用） |
hotkey | press（cmd+shift+tなどのコードを使用） |
swipe | drag --from … --to … |
その他の操作（クリック、タイピング、スクロール、ウィンドウやメニューの管理を含む）については、peekaboo <command> --helpを使用してください。コマンドオプションはリーフコマンドの後に配置し、--jsonは構造化出力を要求します。
検査、操作、検証
アプリケーションのインベントリとターゲットの最新ビューから始めます。
peekaboo app list --json
peekaboo see --app Safari --window-title "Example" --annotate \
--path /tmp/peekaboo-example.png --json
操作前に返された要素を読み取ってください。操作は意図したアプリ、ウィンドウ、最新のスナップショットに結びつけて行い、古いexample要素IDを再利用しないでください。操作後は再度UIを検査し、要求された結果を確認してください。ウィンドウが変更されたり、ターゲットが古くなったりした場合は、観測を更新してください。
要素検出なしのスクリーンショットの場合：
peekaboo see --mode screen --screen-index 0 --no-elements --retina \
--path /tmp/peekaboo-screen.png --json
生のキーボードコードは、明示的なフォアグラウンド操作、またはpressが受け付ける新しい正確なウィンドウ受信を必要とします。ドラッグは常に共有カーソルを移動し、--foregroundを必要とします。フォアグラウンド操作が許可されている場合：
peekaboo press cmd+shift+t --app Safari --foreground --json
peekaboo drag --from 100,500 --to 100,200 --duration 800ms --foreground --json
現在の観測から実際のターゲットと座標を使用してください。800msのような明示的な時間単位を推奨します。各コマンドのオプションと前提条件については、そのコマンドのヘルプを参照してください。
トラブルシューティング
- 削除されたコマンドのエラーについては、インストールされたCLIによって示されている置き換えコマンドを使用してください。
- ホストまたは権限の失敗については、選択したホストの
peekaboo bridge status --jsonとpeekaboo permissions status --jsonを確認してください。 - ターゲティングの失敗については、リーフコマンドのヘルプを読み、
seeで新しいUI状態を取得してください。 - macOS 15+では、プライベートウィンドウピッカープロンプトは基本の画面収録許可とは別になっており、Bridgeの権限が正しい場合でも表示されることがあります。