OpenClaw 🦞

macOS 权限

macOS 权限 (TCC)

macOS 权限授予很脆弱。TCC 将权限授予与应用的代码签名、bundle identifier 和磁盘路径关联。如果其中任何一项发生变化，macOS 会将应用视为新应用，并可能丢弃或隐藏提示。

稳定权限的要求

  • 相同路径：从固定位置运行应用（对于 OpenClaw，dist/OpenClaw.app）。
  • 相同 bundle identifier：更改 bundle ID 会创建新的权限身份。
  • 已签名的应用：未签名或 ad-hoc 签名的构建不会持久化权限。
  • 一致的签名：使用真实的 Apple Development 或 Developer ID 证书，以便签名在重新构建时保持稳定。

Ad-hoc 签名每次构建都会生成新身份。macOS 会忘记之前的授权，提示可能完全消失，直到清除过时的条目。

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

  1. 退出应用。
  2. 在 System Settings -> Privacy & Security 中移除应用条目。
  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

文件和文件夹权限 (Desktop/Documents/Downloads)

macOS 还可能对终端/后台进程限制 Desktop、Documents 和 Downloads 的访问。如果文件读取或目录列表挂起，请向执行文件操作的相同进程上下文授予访问权限（例如 Terminal/iTerm、LaunchAgent 启动的应用或 SSH 进程）。

变通方法：将文件移入 OpenClaw 工作区（~/.openclaw/workspace），以避免逐个文件夹授权。

如果你正在测试权限，务必使用真实证书签名。Ad-hoc 构建仅适用于权限不重要的快速本地运行。