Platforms overview
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.
Download
Baixe builds do app para macOS nas releases do OpenClaw no GitHub. Quando uma release incluir ativos do app para macOS, procure por:
OpenClaw-<version>.dmg(preferencial)OpenClaw-<version>.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.
Primeira execução
- Instale e inicie o OpenClaw.app.
- Escolha Este Mac para um Gateway local, ou conecte-se a um Gateway remoto.
- No modo local, aguarde enquanto o app instala seu runtime em espaço de usuário e o Gateway.
- Conclua a configuração do provedor e a lista de verificação de permissões do macOS.
- Envie a mensagem de teste de integração.
Para o caminho de configuração da CLI/Gateway, use Primeiros passos. Para recuperação de permissões, use permissões do macOS.
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 |
| Remoto | Outro host executa o Gateway e este Mac deve controlá-lo por SSH, LAN ou Tailnet. | Controle remoto |
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 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 |
| Manter o estado fora de pastas sincronizadas na nuvem | Gateway no macOS |
| Depurar descoberta e conectividade do app | Gateway no macOS |
| Entender o comportamento do launchd | Ciclo de vida do Gateway |
| Corrigir permissões ou problemas de assinatura/TCC | Permissões do macOS |
| Conectar-se a um Gateway remoto | Controle remoto |
| Ler status da barra de menus e verificações de integridade | Barra de menus, Verificações de integridade |
| Usar a IU de chat incorporada | WebChat |
| Usar ativação por voz ou pressionar para falar | Ativação por voz |
| Usar Canvas e deep links do Canvas | Canvas |
| Hospedar PeekabooBridge para automação de IU | Ponte Peekaboo |
| Configurar aprovações de comandos | Aprovações de execução, detalhes avançados |
| Inspecionar comandos de nó do Mac e IPC do app | IPC do macOS |
| Capturar logs | Logs do macOS |
| Compilar a partir do código-fonte | Configuração de desenvolvimento no macOS |
