macOS companion app
Permissões do macOS
As concessões de permissão do macOS são frágeis. O TCC associa uma concessão de permissão à assinatura de código do aplicativo, ao identificador do pacote e ao caminho no disco. Se qualquer um deles mudar, o macOS tratará o aplicativo como novo e poderá descartar ou ocultar as solicitações.
Requisitos para permissões estáveis
- Mesmo caminho: execute o aplicativo a partir de um local fixo (para o OpenClaw,
dist/OpenClaw.app). - Mesmo identificador do pacote: o ID do pacote do OpenClaw é
ai.openclaw.mac; alterá-lo cria uma nova identidade de permissão. - Aplicativo assinado: compilações sem assinatura ou com assinatura ad hoc não mantêm as permissões.
- Assinatura consistente: use um certificado Apple Development ou Developer ID válido para que a assinatura permaneça estável entre recompilações.
Assinaturas ad hoc geram uma nova identidade a cada compilação. O macOS esquece as concessões anteriores, e as solicitações podem desaparecer completamente até que as entradas obsoletas sejam removidas.
Concessões de Acessibilidade para ambientes de execução Node e CLI
Prefira conceder Acessibilidade ao OpenClaw.app, Peekaboo.app ou a outro aplicativo auxiliar assinado com seu próprio identificador de pacote, em vez de concedê-la a um binário node genérico.
O TCC do macOS concede Acessibilidade à identidade de código do processo que ele detecta. Se um fluxo de trabalho do Homebrew, nvm, pnpm ou npm fizer com que um executável node compartilhado receba Acessibilidade, qualquer pacote JavaScript iniciado por meio desse mesmo executável poderá herdar privilégios de automação da interface gráfica.
Trate uma entrada node nos Ajustes do Sistema como uma permissão ampla para esse ambiente de execução Node, não como uma permissão para um único pacote npm. Evite conceder Acessibilidade ao node, a menos que você confie em todos os scripts e pacotes iniciados por meio dessa instalação específica do Node.
Se você concedeu Acessibilidade ao node acidentalmente, remova essa entrada em System Settings -> Privacy & Security -> Accessibility. Em seguida, conceda-a ao aplicativo assinado ou ao aplicativo auxiliar que deve controlar a automação da interface.
Lista de verificação para recuperação quando as solicitações desaparecem
- Encerre o aplicativo.
- Remova a entrada do aplicativo em System Settings -> Privacy & Security.
- Reinicie o aplicativo pelo mesmo caminho e conceda novamente as permissões.
- Se a solicitação ainda não aparecer, redefina as entradas do TCC com
tccutile tente novamente. - Algumas permissões só reaparecem após uma reinicialização completa do macOS.
Exemplos de redefinição (usando o ID do pacote do OpenClaw, ai.openclaw.mac):
sudo tccutil reset Accessibility ai.openclaw.macsudo tccutil reset ScreenCapture ai.openclaw.macsudo tccutil reset AppleEventsPermissões de arquivos e pastas (Mesa/Documentos/Downloads)
O macOS também pode restringir o acesso à Mesa, a Documentos e a Downloads para processos de terminal ou em segundo plano. Se a leitura de arquivos ou a listagem de diretórios travar, conceda acesso ao mesmo contexto de processo que realiza as operações de arquivo (por exemplo, Terminal/iTerm, aplicativo iniciado pelo LaunchAgent ou processo SSH).
Solução alternativa: mova os arquivos para o espaço de trabalho do OpenClaw (~/.openclaw/workspace) se quiser evitar concessões específicas por pasta.
Se estiver testando permissões, sempre assine com um certificado válido. Compilações ad hoc são aceitáveis apenas para execuções locais rápidas nas quais as permissões não são relevantes.
