OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS 配套应用

macOS 权限

macOS 权限授予机制较为脆弱。TCC 会将权限授予与应用的代码签名、捆绑包标识符和磁盘路径关联。如果其中任何一项发生变化，macOS 都会将该应用视为新应用，并可能丢弃或隐藏提示。

稳定权限的要求

  • 相同路径：从固定位置运行应用（对于 OpenClaw，为 dist/OpenClaw.app）。
  • 相同捆绑包标识符：OpenClaw 的捆绑包 ID 是 ai.openclaw.mac；更改它会创建新的权限身份。
  • 已签名应用：未签名或使用临时签名的构建无法持久保留权限。
  • 一致的签名：使用真实的 Apple Development 或 Developer ID 证书，确保签名在重新构建后保持稳定。

临时签名会在每次构建时生成新的身份。macOS 会忘记之前授予的权限，并且提示可能完全消失，直到清除过期条目。

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

建议将辅助功能权限授予 OpenClaw.app、Peekaboo.app 或其他拥有自身捆绑包标识符的已签名辅助程序，而不是通用的 node 二进制文件。

macOS TCC 会将辅助功能权限授予它所看到的进程代码身份。如果 Homebrew、nvm、pnpm 或 npm 工作流导致共享的 node 可执行文件获得辅助功能权限，则通过同一可执行文件启动的任何 JavaScript 软件包都可能继承 GUI 自动化权限。

应将系统设置中的 node 条目视为授予该 Node 运行时的广泛权限，而不是授予某个 npm 软件包的权限。除非你信任通过该特定 Node 安装启动的每个脚本和软件包，否则应避免向 node 授予辅助功能权限。

批准辅助功能权限不会启用活动共享。Settings -> Permissions -> Active computer detection 是一项独立且默认关闭的控制项，用于与 Gateway 网关共享有限范围内的空闲时长。将其关闭会清除保留的活动信息，但不会撤销辅助功能权限或断开节点连接。

如果意外向 node 授予了辅助功能权限，请从 System Settings -> Privacy & Security -> Accessibility 中移除该条目。然后向应负责 UI 自动化的已签名应用或辅助程序授予权限。

提示消失时的恢复检查清单

  1. 退出应用。
  2. 在 System Settings -> Privacy & Security 中移除该应用条目。
  3. 从相同路径重新启动应用并重新授予权限。
  4. 如果提示仍未出现，请使用 tccutil 重置 TCC 条目，然后重试。
  5. 某些权限只有在完全重启 macOS 后才会再次出现。

重置示例（使用 OpenClaw 的捆绑包 ID，即 ai.openclaw.mac）：

bash
sudo tccutil reset Accessibility ai.openclaw.macsudo tccutil reset ScreenCapture ai.openclaw.macsudo tccutil reset AppleEvents

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

macOS 还可能限制终端或后台进程访问桌面、文稿和下载文件夹。如果读取文件或列出目录时卡住，请向执行文件操作的同一进程上下文授予访问权限（例如 Terminal/iTerm、由 LaunchAgent 启动的应用或 SSH 进程）。

解决方法：如果想避免逐个授予文件夹权限，请将文件移至 OpenClaw 工作区（~/.openclaw/workspace）。

如果正在测试权限，请始终使用真实证书进行签名。临时签名构建仅适用于无需考虑权限的快速本地运行。

相关内容

Was this useful?
On this page

On this page