Skip to main content
macOS 的权限授权是脆弱的。TCC 会将权限授权与应用的代码签名、bundle 标识符以及磁盘上的路径关联起来。如果其中任何一项发生变化，macOS 会将该应用视为新应用，并可能丢弃或隐藏提示。

​
稳定权限的要求

  • 相同路径：从固定位置运行应用（对于 OpenClaw，使用 dist/OpenClaw.app）。
  • 相同的 bundle 标识符：更改 bundle ID 会创建新的权限身份。
  • 已签名应用：未签名或 ad-hoc 签名的构建不会持久保存权限。
  • 一致的签名：使用真实的 Apple Development 或 Developer ID 证书 以便签名在多次重新构建之间保持稳定。
ad-hoc 签名会在每次构建时生成新的身份。macOS 会忘记之前的 授权，并且提示可能会完全消失，直到清除过期条目。

​
Node 和 CLI 运行时的辅助功能权限授予

优先向 OpenClaw.app、Peekaboo.app 或其他具有自己 bundle 标识符的已签名 辅助程序授予辅助功能权限，而不是授予通用的 node 二进制文件。 macOS TCC 会将辅助功能权限授予其所见进程的代码身份。如果 Homebrew、nvm、pnpm 或 npm 工作流导致共享的 node 可执行文件 获得辅助功能权限，那么通过同一 可执行文件启动的任何 JavaScript 包都可能继承图形界面自动化权限。 在系统设置中看到的 node 条目，应视为该 Node 运行时的广泛权限，而不是某个 npm 包的权限。除非你信任通过该确切 Node 安装启动的所有脚本和包，否则不要向 node 授予辅助功能权限。 如果你不小心向 node 授予了辅助功能权限，请在 系统设置 -> 隐私与安全性 -> 辅助功能 中移除该条目。然后向应当拥有 UI 自动化权限的 已签名应用或辅助程序授予权限。

​
当提示消失时的恢复清单

  1. 退出应用。
  2. 在 系统设置 -> 隐私与安全性 中移除该应用条目。
  3. 从相同路径重新启动应用并重新授予权限。
  4. 如果提示仍然没有出现，使用 tccutil 重置 TCC 条目并重试。
  5. 某些权限只有在完整重启 macOS 后才会重新出现。
重置示例（按需替换 bundle ID）： 
sudo tccutil reset Accessibility ai.openclaw.mac
sudo tccutil reset ScreenCapture ai.openclaw.mac
sudo tccutil reset AppleEvents

​
文件和文件夹权限（桌面/文稿/下载）

对于终端/后台进程，macOS 也可能对桌面、文稿和下载目录进行限制。如果文件读取或目录列表卡住，请向执行文件操作的同一进程上下文授予访问权限（例如 Terminal/iTerm、LaunchAgent 启动的应用，或 SSH 进程）。 变通方法：如果你想避免逐文件夹授权，请将文件移动到 OpenClaw 工作区（~/.openclaw/workspace）。 如果你正在测试权限，请始终使用真实证书签名。ad-hoc 构建只适用于权限无关紧要的快速本地运行场景。

​
相关