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

macOS companion app

Assinatura no macOS

assinatura no Mac (compilações de depuração)

scripts/package-mac-app.sh compila e empacota o aplicativo em um caminho fixo (dist/OpenClaw.app) e, em seguida, chama scripts/codesign-mac-app.sh para assiná-lo. As permissões do TCC estão vinculadas ao ID do pacote e à assinatura de código; manter ambos estáveis (e o aplicativo em um caminho fixo) entre recompilações evita que o macOS esqueça as concessões do TCC (notificações, acessibilidade, gravação de tela, microfone e fala).

  • O identificador do pacote de depuração usa ai.openclaw.mac.debug por padrão (substitua com BUNDLE_ID=...).
  • Node: >=22.22.3 <23, >=24.15.0 <25 ou >=25.9.0 (package.json do repositório engines). O empacotador também compila a interface de controle (pnpm ui:build).
  • Por padrão, exige uma identidade de assinatura real; o script de assinatura de código termina com um erro se nenhuma for encontrada e ALLOW_ADHOC_SIGNING não estiver definido. A assinatura ad hoc (SIGN_IDENTITY="-") requer ativação explícita e não mantém as permissões do TCC entre recompilações. Consulte permissões do macOS.
  • Lê SIGN_IDENTITY do ambiente (por exemplo, export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" ou um certificado Developer ID Application). Sem esse valor, codesign-mac-app.sh seleciona automaticamente uma identidade nesta ordem: Developer ID Application, Apple Distribution, Apple Development e, por fim, a primeira identidade válida de assinatura de código encontrada.
  • CODESIGN_TIMESTAMP=auto (padrão) habilita carimbos de data e hora confiáveis somente para assinaturas Developer ID Application. Defina on/off para forçar qualquer uma das opções.
  • Grava no Info.plist OpenClawBuildTimestamp (UTC ISO8601) e OpenClawGitCommit (hash curto, unknown se indisponível), para que a aba Sobre possa mostrar a compilação, o Git e o canal de depuração/lançamento.
  • Executa uma auditoria do ID da equipe após a assinatura e falha se algum Mach-O dentro do pacote tiver um ID da equipe diferente. Defina SKIP_TEAM_ID_CHECK=1 para ignorar essa verificação.

Uso

bash
# a partir da raiz do repositórioscripts/package-mac-app.sh                                                      # seleciona automaticamente a identidade; gera erro se nenhuma for encontradaSIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # certificado realALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh                                 # ad hoc (as permissões não serão mantidas)SIGN_IDENTITY="-" scripts/package-mac-app.sh                                     # ad hoc explícita (mesma ressalva)DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh                          # solução alternativa somente para desenvolvimento para incompatibilidade do ID da equipe do Sparkle

Observação sobre assinatura ad hoc

SIGN_IDENTITY="-" desabilita o Hardened Runtime (--options runtime) para evitar falhas quando o aplicativo carrega frameworks incorporados (como o Sparkle) que não compartilham o mesmo ID da equipe. Assinaturas ad hoc também impedem a persistência das permissões do TCC; consulte permissões do macOS para ver as etapas de recuperação.

Metadados de compilação para a aba Sobre

A aba Sobre lê OpenClawBuildTimestamp e OpenClawGitCommit do Info.plist para mostrar a versão, a data da compilação, o commit do Git e se a compilação é DEBUG (por meio de #if DEBUG). Execute novamente o empacotador após alterações no código para atualizar esses valores.

Relacionados

Was this useful?
On this page

On this page