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
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.
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 |
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.
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 |