Platforms overview
aplicativo para macOS
O app para macOS é o companheiro da barra de menus do OpenClaw: interface nativa na bandeja, solicitações de permissão do macOS, notificações, WebChat, entrada de voz, Canvas e
ferramentas de Node hospedadas no Mac, como system.run.
Precisa apenas da CLI e do Gateway? Comece por Primeiros passos.
Download
Obtenha as versões do app para macOS nos lançamentos do OpenClaw no GitHub. Quando um lançamento incluir artefatos do app para macOS, procure por:
OpenClaw-<version>.dmg(preferencial)OpenClaw-<version>.zip
Alguns lançamentos incluem apenas a CLI, evidências ou artefatos para Windows. Se o lançamento mais recente não tiver um artefato do app para macOS, use o mais recente que tiver ou compile a partir do código-fonte com a configuração de desenvolvimento para macOS.
Primeira execução
- Instale e inicie o OpenClaw.app.
- Escolha Este Mac para um Gateway local ou conecte-se a um Gateway remoto.
- Aguarde enquanto o app instala o runtime correspondente da CLI. No modo local, ele também instala e inicia o Gateway.
- Estabeleça a inferência com uma verificação de modelo em tempo real. Depois que ela for aprovada, o Crestodian cuida do restante da configuração.
- Conclua a lista de verificação de permissões do macOS e envie a mensagem de teste de integração.
Se o app acessar um Gateway existente cujo agente padrão tenha um modelo configurado, ele considerará esse Gateway já configurado, ignorará a integração do provedor e o Crestodian e abrirá o painel. Se não for possível conectar ao Gateway ou se o agente padrão não tiver um modelo, a integração de inferência continuará disponível para recuperação.
Para o fluxo de configuração da CLI/do Gateway, use Primeiros passos. Para recuperar permissões, use Permissões do macOS.
Atualizações
O cartão de atualização do painel atualiza primeiro o app assinado para macOS por meio do Sparkle.
Depois que o app é reiniciado, ele atualiza e reinicia automaticamente o
Gateway local correspondente gerenciado pelo app. Instalações da CLI gerenciadas pelo usuário via Homebrew e outros meios mantêm
o fluxo normal de atualização do Gateway (o cartão executa diretamente a atualização do Gateway),
e o reparo automático nunca rebaixa um Gateway mais recente nem substitui uma
fixação no canal extended-stable.
O Sparkle segue a configuração update.channel do Gateway. beta e dev habilitam
versões beta do app; stable, extended-stable e valores ausentes ou desconhecidos
permanecem nas versões estáveis do app.
Abrir links do painel
No painel incorporado ao app para macOS, clicar em um link externo da web o abre em uma barra lateral redimensionável do navegador. Cada link é aberto em sua própria aba; clicar novamente no mesmo link reutiliza a aba existente. Arraste as abas para reordená-las, feche-as com o botão de fechar da aba ou com um clique do botão do meio e clique com o botão direito em uma aba para acessar Abrir no navegador padrão, Copiar link, Recarregar, Fechar aba e Fechar outras abas. Os controles de voltar/avançar na barra de título da janela e os gestos no trackpad navegam pelo histórico do painel; os controles próprios de voltar/avançar da barra lateral navegam pelo histórico da aba ativa. A barra lateral também tem controles para recarregar, abrir no navegador padrão e fechar, além de lembrar sua largura.
Os controles da barra de título acompanham a barra lateral do app: enquanto ela está expandida, os controles de voltar/avançar ficam na borda direita, ao lado do botão de alternância da barra lateral; enquanto ela está recolhida, eles dão lugar a um botão de pesquisa (que abre a paleta de comandos) e a um botão de nova sessão.
Clique com o botão direito em um link externo para escolher Abrir na barra lateral, Abrir no navegador padrão ou Copiar link. Cliques modificados e links de nova janela ativados pelo usuário no painel continuam sendo abertos no navegador padrão; links de nova janela dentro da barra lateral são abertos como novas abas da barra lateral. As páginas normais da interface de controle hospedadas no navegador mantêm o comportamento padrão de links e do menu de contexto do navegador.
Importar logins do navegador
Quando o app é executado com um Gateway local e existe no Mac um perfil da família Chrome com cookies, a janela do painel exibe um banner dispensável oferecendo copiar esses cookies para um perfil gerenciado e isolado que os agentes usam para navegação. Escolha um perfil no controle Importar do banner (o Touch ID pode ser necessário); o progresso e a quantidade de cookies importados aparecem na própria interface, e somente os cookies são copiados — as senhas nunca saem do navegador de origem. Dispensar o banner registra a escolha; Configurações → Geral → Login do navegador → Importar… volta a oferecer essa opção a qualquer momento. Consulte Navegador para conhecer o fluxo de importação subjacente e a restrição browser.allowSystemProfileImport.
Escolher um modo de Gateway
| Modo | Use quando | Página de detalhes |
|---|---|---|
| Local | Este Mac deve executar o Gateway e mantê-lo ativo com o launchd. | Gateway no macOS |
| Remoto | Outro host executa o Gateway; este Mac o controla por SSH, LAN ou Tailnet. | Controle remoto |
Ambos os modos exigem uma CLI openclaw instalada, pois o app reutiliza o runtime
do host de Node dela. Em um Mac novo, o app instala automaticamente a CLI correspondente; o modo
local inicia então o assistente do Gateway, enquanto o modo remoto se conecta ao Gateway
selecionado sem iniciar um segundo Gateway local.
Consulte Gateway no macOS para recuperação manual.
O que o app gerencia
- Status da barra de menus, notificações, integridade e WebChat.
- Solicitações de permissão do macOS para tela, microfone, fala, automação e acessibilidade.
- Um Node do Mac que combina Canvas nativo, captura de câmera/tela, notificações, localização e controle do computador com os comandos de sistema, navegador, Plugin, Skills e MCP do host de Node da CLI.
- Solicitações de aprovação de execução para comandos hospedados no Mac.
- Execução no contexto do app para comandos de shell aprovados, preservando a atribuição de permissões do macOS ao app enquanto o runtime da CLI gerencia a política compartilhada do Node.
- Túneis SSH no modo remoto ou conexões diretas com o Gateway.
O app não substitui a documentação do Gateway nem a documentação geral da CLI. Configuração do Gateway, provedores, plugins, canais, ferramentas e segurança estão em suas próprias documentações.
Páginas de detalhes do macOS
| Tarefa | Leia |
|---|---|
| Instalar ou depurar o serviço da CLI/do Gateway | Gateway no macOS |
| Manter o estado fora de pastas sincronizadas com a nuvem | Gateway no macOS |
| Depurar a descoberta e a conectividade do app | Gateway no macOS |
| Entender o comportamento do launchd | Ciclo de vida do Gateway |
| Corrigir problemas de permissões ou assinatura/TCC | Permissões do macOS |
| Detectar o Mac usado mais recentemente | Presença do computador ativo |
| Conectar-se a um Gateway remoto | Controle remoto |
| Consultar o status da barra de menus e as verificações de integridade | Barra de menus, Verificações de integridade |
| Usar a interface de chat incorporada | WebChat |
| Usar ativação por voz ou pressione para falar | Ativação por voz |
| Usar o Canvas e links diretos do Canvas | Canvas |
| Hospedar o PeekabooBridge para automação da interface | Ponte do Peekaboo |
| Configurar aprovações de comandos | Aprovações de execução, detalhes avançados |
| Inspecionar comandos do Node do Mac e o IPC do app | IPC do macOS |
| Capturar logs | Logs do macOS |
| Compilar a partir do código-fonte | Configuração de desenvolvimento para macOS |
