AI / 自動化 2026年4月13日

雲端 Mac mini 上的 OpenClaw:macOS TCC、輔助使用、螢幕錄製與自動化權限(2026)

ProxyMac 工程團隊 2026年4月13日 約 16 分鐘閱讀

在租用的 Mac mini M4香港、日本、韓國、新加坡或美國機房)上跑 OpenClaw 這類代理時,最常見的失敗方式其實很乏味:守護行程能啟動、日誌看起來也正常,但視窗焦點拿不到、像素讀不到、按鍵送不進去。十有八九根因在 透明度、同意與控制(TCC)——在系統設定裡由人工點「允許」之前,macOS 不會把輔助使用或螢幕錄製真正接進你的自動化目標。這份 2026 指南給出五列表格式的權限矩陣七步且不可打亂的授權順序,以及日誌路徑的硬數字,讓你一次把環境配好,然後安心依賴 LaunchAgent 排程鑰匙圈優先的金鑰衛生,而不必再守著筆記本反覆點彈窗。上述邊界穩定後,再透過 MCP 工具伺服器接入指南 擴充工具面——每個 MCP 行程仍繼承同一套權限與金鑰策略。把 TCC 當成發布清單的一項:與程式碼審查、金鑰輪替同級對待,才能在生產裡穩定重現「能點、能截、能鍵入」的行為。

為何雲端 Mac 上的 TCC 比辦公桌更「吵」

個人電腦上你多半是無意識地點完所有彈窗;在 ProxyMac 上團隊往往先 SSH 登入,而純終端機工作階段永遠不會把模態框推到眼前。更糟的是,有人把 OpenClaw.app 丟進 ~/Downloads 或 Dropbox 同步目錄——路徑一變,系統就視為另一套套件實例,舊授權會被悄悄作廢。正確流程是工程化的:先安裝到 /Applications,再安排一次真正的圖形工作階段,最後才談自動化。雲端維運還要考慮時區與值班:誰能在業務視窗內完成那一次圖形授權,應寫進值班表而不是臨時在群組裡喊人。

  • 套件路徑穩定:在 plist 引用二進位檔之前,先把應用程式拖入 /Applications 並完成一次版本對齊。
  • 使用者一致:點「允許」的 UID 必須與執行 launchd 作業的 UID 相同——不要「管理員安裝、一般員工跑」。
  • 遠端現實:螢幕錄製類提示理論上出現在實體主控台;透過 VNC 多數仍可操作,但高延遲容易讓你錯過右上角小條——務必讀下文 VNC 小節。

權限矩陣(每一道門關掉時會發生什麼)

在指責模型延遲或 API 配額之前,先把這張表掃一遍,能省下大量無效排查時間。

權限門 受影響的 OpenClaw 能力 使用者可見現象 首選處理 備註
輔助使用 點選選單、向原生 Cocoa 控制項輸入文字 日誌出現「AXUIElementCreateApplication failed」一類錯誤 升級後在列表裡對該應用程式關再開一次 也會卡住不少 AppleScript 橋接場景
螢幕錄製 以像素為基礎的工具、瀏覽器畫布截取 黑畫面影格或點陣圖句柄為空 重新開啟隱私權面板;macOS 15 小版本後偶需重新授權 無法在無圖形工作階段中授予
自動化(Apple 事件) 在受支援場景下指令碼化 Safari/Chrome 提示「無權向該應用程式傳送 Apple 事件」 在自動化列表裡依目標應用程式逐項核准 建議搭配最小權限瀏覽器設定檔
檔案與資料夾(下載/桌面等) 讀取工程樹、寫入產物 路徑在 Finder 裡明明存在卻回傳 ENOENT 明確授予資料夾;除非政策強制否則避免 blanket 完整磁碟取用 把儲藏庫放在 ~/Developer 可縮小授權範圍
麥克風 / 相機 語音喚醒、會議機器人 系統立即彈出視窗或擷取裝置列表為空 用 QuickTime 做一次測試以觸發首次提示 純文字代理常可跳過——仍應在文件中標明「未使用」

七步授權順序(請勿重排)

  1. 預留圖形視窗:以螢幕共享連線或現場 KVM,確保有人能看見右上角的系統提示。
  2. 安裝到 /Applications 並刪除其他位置的副本,避免隱私權列表裡出現重複套件項。
  3. 從 Finder 互動式啟動一次 OpenClaw,不要用 sudo open,以便請求行程與未來 LaunchAgent 一致。
  4. 依此順序走隱私權與安全性子面板:輔助使用 → 螢幕錄製 → 自動化 → 檔案(按需)→ 麥克風/相機。
  5. 故意觸發一次會失敗的工具(例如無害截圖),強迫系統在列表中插入應用程式列。
  6. 重新啟動一次;TCC 快取很黏,重新啟動能區分「快取拒絕」與真實政策。
  7. 只有到這一步再放入 無人值守排程指南 中的 LaunchAgent,並在 ~/Library/Logs 或你自選路徑下核對日誌。
不要把狀態放在 iCloud 雲碟:同步目錄會破壞 SQLite 支撐的代理狀態並干擾程式碼簽章校驗。請把狀態放在本機卷路徑,並在 說明中心 文件中登記約定。

LaunchAgent、loginwindow 與「無頭半真半假」

launchd 下執行的代理會繼承同一使用者在互動授權後寫入的 TCC 決策。它們不會繼承你在錯誤的 sudo 安裝工作階段裡、以 root 身份點過的核准——於是出現經典分裂:「終端機裡能用,plist 裡掛掉」。若有 UserName 鍵,請與點過「允許」的帳戶嚴格對齊。

交叉閱讀:權限穩定後,用 鑰匙圈模式 輪替金鑰,避免無人值守守護行程從全域可讀 plist 環境字典讀明文 API 金鑰。

遠端 VNC:不進資料中心也能看清彈出視窗

ProxyMac 客戶通常透過加密的螢幕共享連到 mini。對 TCC 來說這一般夠用,前提是暫時關掉過重壓縮(小鎖圖示需要銳利文字)、中途不要有人關掉隱私權視窗,以及避免「遠端套遠端」把標題列縮到無法點的尺寸。位元率與畫質請對照 VNC 說明;並與 SSH 與 VNC 選型指南 一起閱讀,讓工程師在封網期知道何時應退回純 CLI 工作流程。

三個硬數字與下一步該看什麼

  • 上文七步 plist 清單與頁面內嵌的 HowTo JSON-LD 一一對應——可直接抄進內部 Wiki 作為驗收標準。
  • 每次改權限後建議 tail 的三類日誌:代理自有日誌、log stream --predicate 'subsystem == "com.apple.TCC"'(限定到你的測試時間窗),以及安全團隊已在採集的 /var/log/system.log 片段。
  • 五個區域意味著你可能每台裸金屬都要重複一次入職式設定——清單可以指令碼化,但點「允許」不要指令碼化,既脆弱也違背蘋果的設計意圖。

常見問題

能否僅透過 SSH 授予螢幕錄製? 不能——多項提示必須在圖形工作階段出現。請先用 VNC 完成一次,再回到 SSH。

複製磁碟後權限為何壞了? TCC 把核准綁在套件 ID 與簽章上;複製或漂移建置需要重新授權。

LaunchAgent 是否繼承同一套 TCC? 同一使用者引導工作階段下可以;UID 不一致或 root 無 GUI 時不行。

TCC 搞定後,為何 ProxyMac 上的 Mac mini 仍是 OpenClaw 的合適載體

代理的可信度取決於底下的硬體隔離。專用 Apple Silicon M4 Mac mini 提供 arm64 原生瀏覽器、可預測的單租戶 CPU 以支撐並發工具呼叫,以及蘋果框架預設假設的同一套 macOS 堆疊——於是螢幕錄製開啟時,你擷取的是真實 Metal 表面,而不是蹩腳的 x86 模擬差異。把機器放在 香港 / 日本 / 韓國 / 新加坡 / 美國 可與業務已呼叫的 API 同區域共置;ProxyMac 的 SSH 與 VNC 存取模型也貼合平台團隊偵錯 TCC 的習慣:shell 看日誌,GUI 點同意。租賃相對自購把資本支出變成有時間邊界的實驗,特別適合 2026 年可能每月調整方向的代理試點。

一次搞定 TCC,處處自動化

結合說明中心與 VNC 文件,再選擇 Mac mini 區域