macOS 权限 (TCC)

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

稳定权限的要求

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

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

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

1. 退出应用。
2. 在系统设置 -> 隐私与安全性中删除应用条目。
3. 从相同路径重新启动应用并重新授予权限。
4. 如果提示仍未出现,使用 tccutil 重置 TCC 条目并重试。
5. 某些权限仅在完全重启 macOS 后才会重新出现。

重置示例(根据需要替换 bundle ID):

sudo tccutil reset Accessibility bot.molt.mac
sudo tccutil reset ScreenCapture bot.molt.mac
sudo tccutil reset AppleEvents

如果您正在测试权限,请始终使用真实证书签名。Ad-hoc 构建仅适用于不需要权限的快速本地运行。