クラウド Mac mini 上の OpenClaw：アクセシビリティ、画面収録、オートメーションのための macOS TCC 権限（2026）
OpenClaw 型のエージェントを、Mac mini M4 を 香港・日本・韓国・シンガポール・米国 でレンタルして動かすとき、ありがちな失敗は地味です。デーモンは起動しログも健全なのに、ウィンドウフォーカスもピクセルもキー入力も自動化の対象に届かない。十中八九、原因は Transparency, Consent, and Control（TCC）——人間がシステム設定で承認するまで、アクセシビリティや画面収録を macOS が配線しないことです。本2026年版では 5 列の権限マトリクス、順序固定の 7 ステップ付与フロー、ログパスの実数値をまとめ、一度セットアップを終えれば LaunchAgent によるスケジュール と キーチェーン優先のシークレット運用 に任せてノートを常時起きさせずに済むようにします。
なぜクラウド Mac では手元の Mac より TCC が目立つのか
個人用 Mac ではプロンプトを無意識にクリックします。ProxyMac ではまず SSH から入ることが多く、モーダルはそこでは出ません。さらに OpenClaw.app を ~/Downloads や Dropbox 同期フォルダへ置くチームもあり、macOS は別バンドルパスとして扱い、以前の付与を静かに失効させます。対処は手順化です：/Applications へのドラッグインストール、一度の対話型 GUI セッション、その後の自動化です。
- バンドルの安定： plist がバイナリを参照する前に、必ず
/Applicationsへインストールする。 - ユーザー整合： TCC を承認した UID が、
launchdジョブを動かす UID と一致する——「管理者で入れてスタッフで動かす」は不可。 - リモートの現実： 画面収録のプロンプトは物理コンソール上に描画されることがあります。VNC 経由でも多くは動作しますが遅延で右上のオーバーレイを見逃しやすい——下の VNC 節を参照。
エンタープライズでは MDM の「プライバシー設定ペイロード」で一部をプリ承認できますが、画面収録のようなカテゴリは依然として対話が前提のことが多く、クラウド運用では「一度だけ VNC で完了させる」ラインを社内 Wiki に固定しておくとトラブルが減ります。
権限マトリクス（各ゲートが閉じているときに壊れるもの）
オンボーディングでモデル遅延や API 上限を疑う前に、この表をスキャンしてください。
| ゲート | 影響を受ける OpenClaw の機能 | ユーザーに見える症状 | 最初の修復 | 注記 |
|---|---|---|---|---|
| アクセシビリティ | メニュー操作、ネイティブ Cocoa コントロールへの入力 | ログに「AXUIElementCreateApplication failed」 | アップグレード後、アクセシビリティ一覧でアプリを一度オフ→オン | 多くの AppleScript ブリッジもここに依存 |
| 画面収録 | ピクセルベースのツール、ブラウザキャンバスの取得 | 黒フレームや nil のビットマップ | プライバシーペインを再表示；macOS 15 ではマイナーアップデート後に再承認が必要な場合あり | ヘッドレスだけでは付与不可 |
| オートメーション（Apple イベント） | 対応ブラウザの Safari/Chrome 操作 | 「Not authorized to send Apple events」 | オートメーション一覧で対象アプリごとに承認 | 最小権限のブラウザプロファイルと併用 |
| ファイルとフォルダ（ダウンロード／デスクトップ） | プロジェクトツリーの読み取り、アーティファクトの書き込み | Finder では存在するのに ENOENT | 明示的なフォルダを付与；方針が許さない限りフルディスクアクセスは避ける | リポジトリを ~/Developer 配下に置くとスコープが膨らみにくい |
| マイク／カメラ | 音声ウェイク、会議ボット | 即時の OS アラートまたは空のキャプチャデバイス | QuickTime で一度テストしてプロンプトを起こす | テキスト専用エージェントでは省略されがち——「未使用」と文書化しておく価値あり |
7 ステップの付与シーケンス（順序を変えない）
- GUI ウィンドウを確保： 画面共有または現地 KVM で、右上のプロンプトを誰かが見られるようにする。
- /Applications へインストールし、他場所のコピーを削除してプライバシー一覧の重複バンドル ID を避ける。
- OpenClaw を対話的に起動——Finder から一度。将来の LaunchAgent と同一の要求プロセスになるよう
sudo openは使わない。 - プライバシーとセキュリティをこの順で確認：アクセシビリティ → 画面収録 → オートメーション → ファイル（必要に応じて）→ マイク／カメラ。
- わざと失敗しうるツールを実行（害のないスクリーンショットなど）し、OS に一覧行の挿入を促す。
- 一度再起動；TCC のキャッシュは粘り強く、再起動で「キャッシュされた拒否」と実ポリシーを切り分ける。
- ここから先で初めて 無人スケジュールのガイド の LaunchAgent を置き、
~/Library/Logsなど任意パスでログを確認する。
LaunchAgent、loginwindow、ヘッドレスに関する半分だけの真実
launchd 下のエージェントは、同一ユーザーが対話的に承認したあとの TCC 決定を継承します。誤った sudo インストール中に root で付与した承認は継承されません——その不一致が「ターミナルでは動くが plist では失敗」の分断を生みます。UserName キー（ある場合）は「許可」をクリックしたアカウントと揃えてください。
リモート VNC：データセンターへ飛ばずにプロンプトを見せる
ProxyMac のお客様は多くが暗号化された画面共有で mini に入ります。一時的に圧縮を切って細い南京錠アイコンも鮮明にし、ストリーム中に誰もプライバシーウィンドウを閉じないこと、入れ子の「リモートのリモート」で UI が小さくなりすぎないこと——これが満たされれば TCC に十分です。VNC リファレンスのビットレート指針に従い、ロックダウン中は CLI のみに落とすタイミングを SSH と VNC の比較 で整理すると、エンジニア全員が同じ手順を踏めます。
録画やスクリーンショット系のツールは、初回だけ「画面のどの部分を共有するか」のサブダイアログを出すことがあります。バッチジョブに載せる前に、同じユーザー文脈で対話的に一通り触っておくと、夜間ジョブのサイレント失敗を防げます。
3 つの具体数と、次に見る場所
- 上の 7 ステップは本ページに埋め込んだ HowTo JSON-LD と 1:1 対応——社内 Wiki の受け入れ基準にそのまま使えます。
- 権限変更のたびに追う 3 系統のログ：エージェント自身のログ、テスト時間帯にフィルタした
log stream --predicate 'subsystem == "com.apple.TCC"'、セキュリティチームが既に取り込んでいる/var/log/system.logの断片。 - 5 リージョンなら物理ホストごとにオンボーディングを繰り返すことがあります——チェックリストはスクリプト化してよいが、「許可」のクリックをスクリプト化するのは壊れやすく Apple の設計とも逆行です。
FAQ
画面収録は SSH だけで付与できますか？ いいえ——複数のプロンプトにはグラフィカルセッションが必要です。一度 VNC で完了し、その後 SSH に戻してください。
ディスクをクローンしたあと権限が壊れたのはなぜ？ TCC はバンドル ID と署名に紐づきます。クローンやビルドのドリフトでは再承認が必要です。
LaunchAgent は同じ TCC を継承しますか？ 同一ユーザーのブートストラップを共有する場合ははい。UID が異なるか、GUI のない root ジョブの場合はいいえ。
TCC が固まったあと、OpenClaw に ProxyMac の Mac mini が向く理由
エージェントの信頼性は、その下の ハードウェア分離に依存します。専用の Apple Silicon M4 Mac mini は arm ネイティブのブラウザ、並列ツール呼び出しでも予測しやすいシングルテナント CPU、そして Apple のフレームワークが前提とする同一の macOS スタックを提供します。画面収録が有効なら、エミュレートされた x86 の癖ではなく、Metal バックの実画面を取り込めます。香港／日本／韓国／シンガポール／米国 でホストすることで、ビジネスが既に叩いている API と自動化を同居させられ、ProxyMac の SSH／VNC アクセスモデルは TCC デバッグの現場と一致します——ログはシェル、同意は GUI。購入ではなくレンタルにすると設備投資が 期間限定の実験に変わり、2026 年のエージェント試行のように月次で方針が変わるプロジェクトに合います。
