> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS 權限

macOS 的權限授予很脆弱。TCC 會將權限授予與 App 的程式碼簽章、套件識別碼及磁碟上的路徑建立關聯。如果其中任何一項變更，macOS 便會將該 App 視為新的 App，並可能不再顯示或隱藏提示。

## 維持權限穩定的要求

* 相同路徑：從固定位置執行 App（OpenClaw 的位置為 `dist/OpenClaw.app`）。
* 相同套件識別碼：OpenClaw 的套件 ID 為 `ai.openclaw.mac`；變更它會建立新的權限身分。
* 已簽署的 App：未簽署或使用臨時簽章的建置版本無法保留權限。
* 一致的簽章：使用真正的 Apple Development 或 Developer ID 憑證，使簽章在重新建置後仍保持穩定。

臨時簽章會在每次建置時產生新的身分。macOS 會忘記先前授予的權限，而且在清除過時的項目之前，提示可能會完全消失。

## Node 與命令列介面執行階段的輔助使用權限

建議將輔助使用權限授予 OpenClaw\.app、Peekaboo.app，或其他具有自有套件識別碼且已簽署的輔助程式，而不是通用的 `node` 二進位檔。

macOS TCC 會將輔助使用權限授予其所識別之程序的程式碼身分。如果 Homebrew、nvm、pnpm 或 npm 工作流程導致共用的 `node` 執行檔取得輔助使用權限，透過同一執行檔啟動的任何 JavaScript 套件都可能繼承 GUI 自動化權限。

請將「系統設定」中的 `node` 項目視為該 Node 執行階段的廣泛權限，而不是單一 npm 套件的權限。除非你信任透過該 Node 安裝項目啟動的每個指令碼與套件，否則請避免將輔助使用權限授予 `node`。

核准輔助使用權限並不會啟用活動分享。**Settings -> Permissions -> Active computer detection** 是另一個預設關閉的控制項，用於與你的閘道分享有限範圍的閒置時間。關閉此功能會清除保留的活動資料，但不會撤銷輔助使用權限或中斷節點連線。

如果你不慎將輔助使用權限授予 `node`，請從 System Settings -> Privacy & Security -> Accessibility 移除該項目。接著，將權限授予應負責 UI 自動化的已簽署 App 或輔助程式。

## 提示消失時的復原檢查清單

1. 結束 App。
2. 在 System Settings -> Privacy & Security 中移除 App 項目。
3. 從相同路徑重新啟動 App，並再次授予權限。
4. 如果提示仍未出現，請使用 `tccutil` 重設 TCC 項目，然後再試一次。
5. 有些權限只有在完整重新啟動 macOS 後才會再次出現。

重設範例（使用 OpenClaw 的套件 ID：`ai.openclaw.mac`）：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo tccutil reset Accessibility ai.openclaw.mac
sudo tccutil reset ScreenCapture ai.openclaw.mac
sudo tccutil reset AppleEvents
```

## 檔案與檔案夾權限（桌面／文件／下載項目）

macOS 也可能限制終端機或背景程序存取桌面、文件及下載項目。如果讀取檔案或列出目錄時停滯，請將存取權授予實際執行檔案操作的相同程序環境（例如 Terminal/iTerm、由 LaunchAgent 啟動的 App 或 SSH 程序）。

因應方法：若要避免逐一授予檔案夾權限，請將檔案移至 OpenClaw 工作區（`~/.openclaw/workspace`）。

如果你正在測試權限，請務必使用真正的憑證進行簽署。只有在權限並不重要的快速本機執行情境下，才可接受臨時簽章的建置版本。

## 相關內容

* [macOS App](/zh-TW/platforms/macos)
* [macOS 簽署](/zh-TW/platforms/mac/signing)