Mac 签名（调试构建）

scripts/package-mac-app.sh 会构建应用并将其打包到固定路径（dist/OpenClaw.app），然后调用 scripts/codesign-mac-app.sh 对其签名。TCC 权限与软件包 ID 和代码签名绑定；在每次重新构建时保持二者稳定（并将应用置于固定路径），可避免 macOS 忘记 TCC 授权（通知、辅助功能、屏幕录制、麦克风、语音）。

• 调试软件包标识符默认为 ai.openclaw.mac.debug（可使用 BUNDLE_ID=... 覆盖）。
• Node：>=22.22.3 <23、>=24.15.0 <25 或 >=25.9.0（仓库 package.json engines）。打包工具还会构建 Control UI（pnpm ui:build）。
• 默认需要真实的签名身份；如果找不到签名身份且未设置 ALLOW_ADHOC_SIGNING，代码签名脚本将报错退出。临时签名（SIGN_IDENTITY="-"）需要明确选择启用，并且无法在重新构建后保留 TCC 权限。请参阅 macOS 权限。
• 从环境中读取 SIGN_IDENTITY（例如 export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" 或 Developer ID Application 证书）。如果未提供，codesign-mac-app.sh 将按以下顺序自动选择身份：Developer ID Application、Apple Distribution、Apple Development，然后是找到的第一个有效代码签名身份。
• CODESIGN_TIMESTAMP=auto（默认值）仅为 Developer ID Application 签名启用可信时间戳。设置 on/off 可强制启用或禁用。
• 使用 OpenClawBuildTimestamp（ISO8601 UTC）和 OpenClawGitCommit（短哈希；不可用时为 unknown）写入 Info.plist，以便“关于”标签页显示构建、git 和调试/发布渠道。
• 签名后运行 Team ID 审计；如果软件包内任何 Mach-O 的 Team ID 不同，则操作失败。设置 SKIP_TEAM_ID_CHECK=1 可绕过此检查。

用法

# 从仓库根目录运行scripts/package-mac-app.sh                                                      # 自动选择身份；如果找不到则报错SIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # 真实证书ALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh                                 # 临时签名（权限不会保留）SIGN_IDENTITY="-" scripts/package-mac-app.sh                                     # 明确使用临时签名（注意事项相同）DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh                          # 仅用于开发的 Sparkle Team ID 不匹配解决方法

临时签名注意事项

SIGN_IDENTITY="-" 会禁用强化运行时（--options runtime），以防应用加载 Team ID 不同的嵌入式框架（如 Sparkle）时崩溃。临时签名也会导致 TCC 权限无法持久保留；有关恢复步骤，请参阅 macOS 权限。

“关于”的构建元数据

“关于”标签页从 Info.plist 读取 OpenClawBuildTimestamp 和 OpenClawGitCommit，以显示版本、构建日期、git 提交，以及构建是否为 DEBUG（通过 #if DEBUG 判断）。代码更改后，请重新运行打包工具以刷新这些值。

相关内容

• macOS 应用
• macOS 权限