macOSのUI自動化を効率化する：OpenClawでPeekaboo Bridgeを動かす

macOSのUI自動化を設定する際、パーミッションの管理や環境構築に苦労したことはありませんか？特にスクリプトからシステムを操作しようとすると、権限のエラーに直面したり、設定画面を何度も往復したりすることになりがちです。

OpenClawの Peekaboo Bridge 機能を使えば、こうした手間を減らしてスムーズに自動化を開始できます。OpenClawがUI自動化の仲介役（ブローカー）として機能するため、macOSアプリが持つ権限をそのまま活用して peekaboo CLI から操作が可能になります。

必要なもの

このセットアップを始める前に、以下の準備ができているか確認してください。

• OpenClaw.app: ホストとして動作します。
• peekaboo CLI: 操作を行うためのクライアントです。

クイックスタート

わずか数ステップで、OpenClawをUI自動化のホストとして設定できます。

1. ブリッジを有効にする OpenClaw.appを開き、 Settings → Enable Peekaboo Bridge をオンにします。これにより、ローカルで UNIX socket サーバーが起動します。

2. ステータスの確認 正しくホストが認識されているか、ターミナルで以下のコマンドを実行して確認してください。

   peekaboo bridge status --verbose

3. （任意）ソケットパスの指定 特定のパスを使用したい場合は、環境変数で上書きも可能です。

   export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

これで、peekaboo CLI から OpenClaw を経由してUI操作を実行できるようになります。

クライアントの優先順位

peekaboo クライアントは、以下の順番でホストを探します。

1. Peekaboo.app（フル機能のUX）
2. Claude.app（インストールされている場合）
3. OpenClaw.app（軽量なブローカー）
4. その他の利用可能なホスト

Security & Permissions

このブリッジは、セキュリティを考慮して設計されています。

• 署名の検証: ブリッジは呼び出し元のコード署名を検証します。許可された TeamID（Peekaboo および OpenClaw）のみが実行可能です。
• タイムアウト: リクエストは10秒後にタイムアウトします。
• エラー通知: 必要な権限が不足している場合、システム設定を開くのではなく、具体的なエラーメッセージを返します。

なお、自動化で使用する Snapshot はメモリ内に保存され、短時間で自動的に破棄されます。長期間保存が必要な場合は、クライアント側で再度キャプチャを行ってください。

トラブルシューティング

よくある問題と解決策をまとめました。

• 「bridge client is not authorized」と表示される クライアントが正しく署名されているか確認してください。デバッグ目的であれば、ホストを PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 を設定して起動することで、未署名のクライアントを許可できます。
• ホストが見つからない OpenClaw.app が起動しているか、設定で Bridge が有効になっているかを確認してください。また、macOSの権限が許可されているかも併せて確認が必要です。

---

さらに詳しい設定やトラブルシューティングが必要な場合は、AI Setup Assistant に相談してください。

次のステップ

• Peekaboo CLI Reference
• OpenClaw Settings Guide