跳转到主要内容
macOS 权限授予很脆弱。TCC 会将权限授予与应用的代码签名、bundle 标识符和磁盘路径关联起来。如果其中任何一项发生变化，macOS 会将该应用视为新应用，并可能丢弃或隐藏提示。

​
稳定权限的要求

  • 相同路径：从固定位置运行应用（对于 OpenClaw，是 dist/OpenClaw.app）。
  • 相同 bundle 标识符：OpenClaw 的 bundle ID 是 ai.openclaw.mac；更改它会创建新的权限身份。
  • 已签名应用：未签名或 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 包都可能继承 GUI 自动化权限。 将系统设置中的 node 条目视为该 Node 运行时的广泛权限，而不是某个 npm 包的权限。除非你信任通过该精确 Node 安装启动的每个脚本和包，否则避免向 node 授予辅助功能权限。 如果你误将辅助功能权限授予了 node，请从系统设置 -> 隐私与安全性 -> 辅助功能中移除该条目。然后向应拥有 UI 自动化的已签名应用或辅助应用授予权限。

​
提示消失时的恢复清单

  1. 退出应用。
  2. 在系统设置 -> 隐私与安全性中移除应用条目。
  3. 从相同路径重新启动应用，并重新授予权限。
  4. 如果提示仍未出现，请使用 tccutil 重置 TCC 条目，然后重试。
  5. 某些权限只有在完整重启 macOS 后才会重新出现。
重置示例（使用 OpenClaw 的 bundle ID，ai.openclaw.mac）： 
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 构建仅适用于权限无关紧要的快速本地运行。

​
相关