ClawCN - OpenClaw 中文版

主题

mac 签名(调试版本) ​

此应用通常从 scripts/package-mac-app.sh 构建,现在会:

  • 设置稳定的调试 bundle 标识符:ai.openclaw.mac.debug
  • 使用该 bundle id 写入 Info.plist(通过 BUNDLE_ID=... 覆盖)
  • 调用 scripts/codesign-mac-app.sh 对主二进制文件和应用 bundle 进行签名,使 macOS 将每次重新构建视为相同的已签名 bundle 并保留 TCC 权限(通知、辅助功能、屏幕录制、麦克风、语音)。要获得稳定的权限,请使用真实的签名身份;临时签名需要选择加入且不稳定(参见 macOS 权限)。
  • 默认使用 CODESIGN_TIMESTAMP=auto;它为 Developer ID 签名启用可信时间戳。设置 CODESIGN_TIMESTAMP=off 可跳过时间戳(离线调试构建)。
  • 将构建元数据注入 Info.plist:OpenClawBuildTimestamp(UTC)和 OpenClawGitCommit(短哈希),以便"关于"面板可以显示构建、git 和调试/发布渠道信息。
  • 打包需要 Node 22+:脚本运行 TS 构建和 Control UI 构建。
  • 从环境变量读取 SIGN_IDENTITY。将 export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)"(或您的 Developer ID Application 证书)添加到 shell rc 中,以始终使用您的证书进行签名。临时签名需要通过 ALLOW_ADHOC_SIGNING=1 或 SIGN_IDENTITY="-" 明确选择加入(不建议用于权限测试)。
  • 签名后运行 Team ID 审计,如果应用 bundle 内的任何 Mach-O 由不同的 Team ID 签名,则会失败。设置 SKIP_TEAM_ID_CHECK=1 可绕过。

用法 ​

bash
# from repo root
scripts/package-mac-app.sh               # auto-selects identity; errors if none found
SIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # real cert
ALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh    # ad-hoc (permissions will not stick)
SIGN_IDENTITY="-" scripts/package-mac-app.sh        # explicit ad-hoc (same caveat)
DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh   # dev-only Sparkle Team ID mismatch workaround

临时签名注意事项 ​

使用 SIGN_IDENTITY="-"(临时签名)进行签名时,脚本会自动禁用加固运行时(--options runtime)。这对于防止应用尝试加载不共享相同 Team ID 的嵌入式框架(如 Sparkle)时崩溃是必要的。临时签名还会破坏 TCC 权限持久性;恢复步骤请参见 macOS 权限。

关于页面的构建元数据 ​

package-mac-app.sh 为 bundle 标记:

  • OpenClawBuildTimestamp:打包时的 ISO8601 UTC 时间
  • OpenClawGitCommit:短 git 哈希(如果不可用则为 unknown)

"关于"选项卡读取这些键以显示版本、构建日期、git 提交以及是否为调试版本(通过 #if DEBUG)。代码更改后运行打包程序以刷新这些值。

原因 ​

TCC 权限与 bundle 标识符_和_代码签名绑定。使用变化的 UUID 的未签名调试版本会导致 macOS 在每次重新构建后忘记授权。对二进制文件进行签名(默认为临时签名)并保持固定的 bundle id/路径(dist/OpenClaw.app)可在构建之间保留授权,与 VibeTunnel 方法一致。