system.run.
Precisa apenas da CLI e do Gateway? Comece com Primeiros passos.
Download
Obtenha as versões do aplicativo para macOS nas versões do OpenClaw no GitHub. Quando uma versão incluir artefatos do aplicativo para macOS, procure por:OpenClaw-<version>.dmg(preferencial)OpenClaw-<version>.zip
Primeira execução
- Instale e inicie o OpenClaw.app.
- Escolha This Mac para um Gateway local ou conecte-se a um Gateway remoto.
- Aguarde enquanto o aplicativo 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 funcionamento. Após a aprovação, o OpenClaw 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.
Atualizações
O cartão de atualização do painel informa o que o aplicativo atualizará:- Update Mac app + Gateway significa que o aplicativo assinado é responsável pelo Gateway local do launchd. O Sparkle atualiza primeiro o aplicativo; após a reinicialização, o aplicativo atualiza e reinicia automaticamente seu Gateway na versão correspondente e, em seguida, verifica a conexão.
- Update Gateway significa que o aplicativo está conectado a um Gateway remoto, a um Gateway local gerenciado manualmente ou a outra instalação pela qual o aplicativo não é responsável. O botão executa o processo normal de atualização desse Gateway em vez de alterar o aplicativo para Mac.
extended-stable.
Após uma atualização bem-sucedida, o aplicativo encontra a sessão direta de nível superior
usada mais recentemente por uma pessoa e envia a esse agente um evento de atualização único. As atividades de Heartbeat
e Cron não afetam essa escolha. O agente pode então receber o usuário de volta
na conversa que ele provavelmente estava usando. No modo remoto, o aplicativo
atualiza apenas o runtime local do Node no Mac e ignora a notificação quando o
Gateway remoto é mais antigo que o aplicativo.
O Sparkle segue a configuração update.channel do Gateway. beta e dev habilitam
as versões beta do aplicativo; stable, extended-stable e valores ausentes ou desconhecidos
permanecem nas versões estáveis do aplicativo.
Abrir links do painel
No painel integrado do aplicativo para macOS, clicar em um link externo da Web o abre em uma barra lateral redimensionável do navegador, ocupando metade da largura da janela e mantendo a navegação do painel visível. Arraste o divisor para escolher outra largura; o aplicativo memoriza essa escolha. Cada link é aberto em sua própria aba, a barra de abas aparece quando várias páginas estão abertas e 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 Open in Default Browser, Copy Link, Reload, Close Tab e Close Other Tabs. Os controles de voltar/avançar da 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. Os controles da barra de título acompanham a barra lateral do aplicativo: 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 Open in Sidebar, Open in Default Browser ou Copy Link. Cliques com teclas modificadoras e links para novas janelas ativados pelo usuário no painel continuam sendo abertos no navegador padrão; links para novas janelas dentro da barra lateral são abertos como novas abas da barra lateral. As páginas comuns da interface de controle hospedadas no navegador mantêm o comportamento normal de links e do menu de contexto do navegador.Importar logins do navegador
Na primeira vez que a barra lateral do navegador é aberta enquanto o aplicativo está conectado a um Gateway local, o painel mostra um banner dispensável quando existe no Mac um perfil da família Chrome com cookies. O banner oferece a opção de copiar esses cookies para um perfil gerenciado isolado que os agentes usam para navegação. Escolha um perfil no controle Import (o Touch ID pode ser necessário); o progresso e a quantidade de cookies importados aparecem na própria tela, e somente os cookies são copiados — as senhas nunca saem do navegador de origem. Dispensar o banner registra a escolha; Settings → General → Browser login → Import… volta a oferecê-la a qualquer momento. Consulte Navegador para conhecer o processo de importação subjacente e a restriçãobrowser.allowSystemProfileImport.
Escolher um modo do Gateway
Ambos os modos precisam de uma CLI
openclaw instalada porque o aplicativo reutiliza seu runtime
de host do Node. Em um Mac novo, o aplicativo 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.
Responsabilidades do aplicativo
- 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 aplicativo para comandos de shell aprovados, preservando a atribuição de permissões do macOS ao aplicativo 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.