> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # app para macOS O app para macOS é o **companheiro da barra de menus** do OpenClaw. Use-o quando quiser uma IU nativa na bandeja, prompts de permissão do macOS, notificações, WebChat, entrada por voz, Canvas ou ferramentas de nó hospedadas no Mac, como `system.run`. Se você só precisa da CLI e do Gateway, comece com [Primeiros passos](/pt-BR/start/getting-started). ## Download Baixe builds do app para macOS nas [releases do OpenClaw no GitHub](https://github.com/openclaw/openclaw/releases). Quando uma release incluir ativos do app para macOS, procure por: * `OpenClaw-.dmg` (preferencial) * `OpenClaw-.zip` Algumas releases incluem apenas CLI, evidências ou ativos para Windows. Se a release mais recente não tiver nenhum ativo do app para macOS, use a release mais recente que tenha, ou compile o app a partir do código-fonte com [configuração de desenvolvimento no macOS](/pt-BR/platforms/mac/dev-setup). ## Primeira execução 1. Instale e inicie o **OpenClaw\.app**. 2. Escolha **Este Mac** para um Gateway local, ou conecte-se a um Gateway remoto. 3. No modo local, aguarde enquanto o app instala seu runtime em espaço de usuário e o Gateway. 4. Conclua a configuração do provedor e a lista de verificação de permissões do macOS. 5. Envie a mensagem de teste de integração. Para o caminho de configuração da CLI/Gateway, use [Primeiros passos](/pt-BR/start/getting-started). Para recuperação de permissões, use [permissões do macOS](/pt-BR/platforms/mac/permissions). ## Escolha um modo de Gateway | Modo | Use quando | Página de detalhes | | ------ | --------------------------------------------------------------------------------- | -------------------------------------------------------- | | Local | Este Mac deve executar o Gateway e mantê-lo ativo com launchd. | [Gateway no macOS](/pt-BR/platforms/mac/bundled-gateway) | | Remoto | Outro host executa o Gateway e este Mac deve controlá-lo por SSH, LAN ou Tailnet. | [Controle remoto](/pt-BR/platforms/mac/remote) | O modo local exige uma CLI `openclaw` instalada. Em um Mac novo, o app instala automaticamente a CLI e o runtime correspondentes antes de iniciar o assistente do Gateway. Consulte [Gateway no macOS](/pt-BR/platforms/mac/bundled-gateway) para recuperação manual. ## O que o app controla * Status da barra de menus, notificações, integridade e WebChat. * Prompts de permissão do macOS para tela, microfone, fala, automação e acessibilidade. * Ferramentas de nó locais, como Canvas, captura de câmera/tela, notificações e `system.run`. * Prompts de aprovação de execução para comandos hospedados no Mac. * Túneis SSH em modo remoto ou conexões diretas ao Gateway. O app **não** substitui a documentação do Gateway do OpenClaw nem da CLI geral. A configuração central do Gateway, provedores, plugins, canais, ferramentas e segurança ficam em suas próprias documentações. ## Páginas de detalhes do macOS | Tarefa | Leia | | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Instalar ou depurar o serviço CLI/Gateway | [Gateway no macOS](/pt-BR/platforms/mac/bundled-gateway) | | Manter o estado fora de pastas sincronizadas na nuvem | [Gateway no macOS](/pt-BR/platforms/mac/bundled-gateway#state-directory-on-macos) | | Depurar descoberta e conectividade do app | [Gateway no macOS](/pt-BR/platforms/mac/bundled-gateway#debug-app-connectivity) | | Entender o comportamento do launchd | [Ciclo de vida do Gateway](/pt-BR/platforms/mac/child-process) | | Corrigir permissões ou problemas de assinatura/TCC | [Permissões do macOS](/pt-BR/platforms/mac/permissions) | | Conectar-se a um Gateway remoto | [Controle remoto](/pt-BR/platforms/mac/remote) | | Ler status da barra de menus e verificações de integridade | [Barra de menus](/pt-BR/platforms/mac/menu-bar), [Verificações de integridade](/pt-BR/platforms/mac/health) | | Usar a IU de chat incorporada | [WebChat](/pt-BR/platforms/mac/webchat) | | Usar ativação por voz ou pressionar para falar | [Ativação por voz](/pt-BR/platforms/mac/voicewake) | | Usar Canvas e deep links do Canvas | [Canvas](/pt-BR/platforms/mac/canvas) | | Hospedar PeekabooBridge para automação de IU | [Ponte Peekaboo](/pt-BR/platforms/mac/peekaboo) | | Configurar aprovações de comandos | [Aprovações de execução](/pt-BR/tools/exec-approvals), [detalhes avançados](/pt-BR/tools/exec-approvals-advanced) | | Inspecionar comandos de nó do Mac e IPC do app | [IPC do macOS](/pt-BR/platforms/mac/xpc) | | Capturar logs | [Logs do macOS](/pt-BR/platforms/mac/logging) | | Compilar a partir do código-fonte | [Configuração de desenvolvimento no macOS](/pt-BR/platforms/mac/dev-setup) | ## Relacionados * [Plataformas](/pt-BR/platforms) * [Primeiros passos](/pt-BR/start/getting-started) * [Gateway](/pt-BR/gateway) * [Aprovações de execução](/pt-BR/tools/exec-approvals)