O OpenClaw pode ser instalado no Mac de várias formas, conforme seu jeito de trabalhar e de gerenciar a configuração. Neste guia, você encontra instruções passo a passo para diferentes métodos de instalação, além de dicas para deixar o OpenClaw funcionando sem problemas.
Visão rápida: três formas de instalar o OpenClaw no Mac
Veja uma comparação lado a lado dos três métodos. Eles variam na quantidade de configuração manual que você precisa fazer.
| Instalador de uma linha | Homebrew | Kimi Claw (Online) | |
|---|---|---|---|
| O que é | Script oficial de instalação que baixa e configura o OpenClaw automaticamente | Configuração manual usando o Homebrew para instalar dependências (como Node.js) e depois executar o OpenClaw pela CLI | Ferramenta online que permite executar o OpenClaw na nuvem sem configuração manual |
| Etapas manuais necessárias | Pouquíssimas etapas manuais | Exige várias etapas manuais | Não exige configuração manual |
| Código ou terminal necessário | Sim | Sim | Não |
| Disponibilidade 24/7 | Só funciona enquanto o Mac está ativo | Só funciona enquanto o Mac está ativo | Roda 24/7 na nuvem |
| Ideal para | Quem está começando e quer a configuração local mais rápida | Desenvolvedores que preferem gerenciar pacotes pelo Homebrew | Usuários que querem executar o OpenClaw sem configuração local |
O Kimi Claw permite executar o OpenClaw na nuvem sem configurar Node.js, Homebrew nem chaves de API. Em poucos minutos, você começa a usar um agent funcional diretamente no navegador.
Se preferir uma configuração local, avance para a próxima seção. Se quiser uma opção mais simples, vá para a seção Executar o OpenClaw no Mac com o Kimi Claw ou clique no botão abaixo para começar na hora.
Antes de começar: preparação essencial e segurança
Antes de instalar o OpenClaw localmente no Mac, é preciso concluir algumas etapas de preparação e segurança. Se você pretende usar o Kimi Claw, pode pular esta seção e ir direto para as instruções de configuração abaixo.
Dependências: O instalador de uma linha instala o Node.js automaticamente, se necessário. Se você escolher o Homebrew, precisará instalar o Node.js manualmente (Node 24 recomendado; Node 22 LTS 22.16+ também funciona).
Firewall e configurações de rede: O firewall do macOS costuma vir desativado por padrão. Você pode ativá-lo em Ajustes do Sistema > Rede > Firewall. O OpenClaw vincula o gateway a 127.0.0.1 (localhost), portanto outros dispositivos na sua rede não conseguem se conectar a ele diretamente. Se precisar de acesso móvel ou remoto, use ferramentas como Tailscale ou um túnel SSH. Não encaminhe a porta
18789pelo roteador.
Instalar o OpenClaw no Mac com o script de uma linha
Esta é a forma mais rápida de executar o OpenClaw localmente no Mac. O OpenClaw roda pelo Terminal e oferece uma interface baseada no navegador para gerenciar seu agent, em vez de um app gráfico tradicional. Um único comando instala a CLI, verifica a versão do Node.js e inicia o assistente de configuração inicial.
Etapa 1. Execute o script de instalação no Terminal
Abra o Terminal pelo Spotlight (⌘ + Space) e cole o comando a seguir:
O script detecta seu sistema, instala a CLI do OpenClaw e verifica a versão do Node.js. Se o Node.js estiver ausente ou desatualizado, ele instala o Node 24 automaticamente (Node 22 LTS 22.16+ também é compatível).
Etapa 2. Defina sua chave de API e configure o gateway
O assistente de configuração inicial começa automaticamente após o término da instalação. Selecione Moonshot AI (Kimi K2.5) como provedor de LLM e cole sua chave da Kimi API quando solicitado. Aceite as configurações padrão de porta do gateway e autenticação. Se quiser que o OpenClaw inicie automaticamente quando o Mac ligar, escolha a opção de instalação do daemon durante a configuração inicial.
Etapa 3. Verifique o gateway e abra o dashboard
Execute o comando a seguir para conferir se o gateway está em execução:
Depois, abra o dashboard:
Esse comando abre a Control UI no navegador em http://127.0.0.1:18789. Informe o token do gateway para entrar. Depois do login, você já pode interagir com seu agent OpenClaw.
Instalar o OpenClaw no Mac com Homebrew
Se você prefere gerenciar pacotes com o Homebrew, pode instalar o OpenClaw no Mac com uma configuração mais manual. Esse método oferece mais controle sobre as dependências e se encaixa no seu fluxo de trabalho atual com Homebrew.
Etapa 1. Instale o Homebrew
Abra o Terminal pelo Spotlight (⌘ + Space). Se você não tiver o Homebrew instalado, execute o comando a seguir. O Homebrew é um gerenciador de pacotes para macOS que permite instalar e gerenciar ferramentas de desenvolvimento pelo Terminal, de forma semelhante a uma loja de apps.
Durante a instalação, pode ser solicitado que você informe a senha de login do Mac. Por segurança, o Terminal não exibirá nenhum caractere enquanto você digita. Também podem aparecer solicitações para confirmar a instalação e mensagens mostrando os arquivos sendo instalados.
Quando a instalação terminar, você verá uma mensagem de sucesso e as próximas etapas no Terminal.
Etapa 2. Instale o Node.js
Depois de instalar o Homebrew, instale o Node.js:
Após a instalação, confirme se a versão é v24 (recomendada) ou v22.16+.
Etapa 3. Instale a CLI do OpenClaw e execute a configuração inicial
Instale a CLI globalmente com npm e execute a configuração inicial:
Se aparecer um erro de permissão EACCES durante npm install -g, o diretório global do npm precisa de acesso elevado. Execute sudo npm install -g openclaw@latest ou altere o diretório padrão do npm para evitar o uso de sudo no futuro.
A flag --install-daemon registra o OpenClaw como um LaunchAgent, para que o gateway inicie automaticamente quando você fizer login. Durante a configuração inicial, selecione Moonshot AI (Kimi K2.5) como provedor e informe sua chave da Kimi API.
Etapa 4. Verifique o gateway e abra o dashboard
Verifique se o gateway está em execução e abra o dashboard:
A Control UI será aberta no navegador. Informe seu token do gateway, e pronto.
Executar o OpenClaw no Mac usando o Kimi Claw
Kimi Claw é uma ferramenta online que permite executar o OpenClaw na nuvem sem configuração local. Não há nada para instalar no Mac, e você não precisa usar o Terminal nem gerenciar dependências. Tudo roda no navegador. Em poucos minutos, você pode criar um agent OpenClaw. O Kimi Claw cuida do gateway, do workspace, do armazenamento e do acesso ao modelo, para que seu agent permaneça online 24/7, mesmo com o MacBook fechado.
Como usar o Kimi Claw?
Etapa 1. Abra o Kimi Claw
Acesse a página do Kimi Claw e clique em Criar para começar a implantar seu ambiente OpenClaw.
Etapa 2. Implante o OpenClaw automaticamente
Confirme a implantação na janela pop-up. Em seguida, o Kimi Claw configura o ambiente OpenClaw, incluindo o gateway, o workspace e as ferramentas. O processo geralmente termina em poucos minutos.
Etapa 3. Comece a usar o OpenClaw
Quando a implantação terminar, seu workspace será aberto no dashboard. Converse com seu agent, configure skills, agende tarefas e gerencie arquivos, tudo pelo navegador.
Diferenças entre o Kimi Claw e a execução local do OpenClaw
O Kimi Claw oferece uma forma mais simples de executar o OpenClaw sem configuração local. Em vez de instalar dependências e gerenciar um ambiente local, você executa seu agent diretamente no navegador enquanto o Kimi Claw cuida da configuração e da infraestrutura por trás.
Sem configuração local: Execute o OpenClaw sem instalar Node.js nem usar o Terminal. Tudo funciona diretamente no navegador, para você começar mais rápido e evitar problemas de configuração de ambiente.
Acesso instantâneo a mais de 5.000 skills: Em vez de instalar ferramentas manualmente, o Kimi Claw pode usar automaticamente as skills necessárias para sua tarefa a partir de uma grande biblioteca de ferramentas disponíveis, reduzindo o tempo de configuração e problemas de compatibilidade.
Automação e agendamento sempre ativos: Diferentemente de agents locais, que param quando o Mac entra em repouso, o Kimi Claw roda 24/7 na nuvem, sendo adequado para tarefas agendadas e fluxos de trabalho de longa duração.
40GB de armazenamento em nuvem e memória persistente: Ao contrário das configurações locais, em que os arquivos geralmente ficam vinculados a um único dispositivo, o Kimi Claw inclui 40GB de armazenamento, deixando seus relatórios e pesquisas acessíveis de qualquer navegador. Ele também lembra suas preferências e o contexto do trabalho entre sessões, para você continuar de onde parou.
Modelo Kimi K2.5 integrado e busca de nível profissional: O Kimi Claw vem com acesso integrado ao Kimi K2.5 e recursos avançados de busca, sem que você precise gerenciar chaves de API nem configurar serviços externos. Ele pode trazer automaticamente informações atualizadas de áreas como finanças, tecnologia e notícias, tornando a pesquisa e a execução de tarefas mais fluidas.
Manter o OpenClaw em execução 24/7 no Mac
A maioria dos usuários trata a AI como um app de desktop tradicional: usa enquanto está na mesa e fecha quando termina. Para automações valiosas, como monitorar mercados globais durante a noite ou receber um relatório de pesquisa na caixa de entrada às 8h, seu agent precisa permanecer ativo o tempo todo. Como o macOS pausa naturalmente processos locais quando o sistema entra em repouso, isso exige uma estratégia específica. Esta seção apresenta duas formas de manter uma conexão persistente:
Opção A: hardware Mac dedicado
Uma opção é manter um Mac (como um Mac mini) em execução contínua. Você pode desativar o repouso com sudo pmset -a sleep 0 e ativar “Despertar para acesso à rede” em Ajustes do Sistema. Para acesso remoto, use ferramentas como Tailscale ou um túnel SSH.
Essa configuração mantém o OpenClaw rodando no seu próprio hardware, mas exige deixar a máquina ligada e cuidar por conta própria de manutenção, atualizações e reinicializações.
Opção B: o Kimi Claw cuida disso automaticamente
Ao executar seu agent com o Kimi Claw, a disponibilidade 24/7 já vem incluída. Seu agent roda de forma independente do dispositivo local, continuando a trabalhar mesmo quando o Mac está fechado ou offline. Não é preciso ajustar as configurações de repouso nem manter uma máquina ligada.
Corrigir erros comuns de instalação do OpenClaw no Mac
Mesmo com uma configuração simples, podem surgir problemas durante a instalação. Veja alguns casos comuns e como resolvê-los.
Erro de comando OpenClaw não encontrado
Causa: O diretório bin global do npm não está no PATH do seu shell.
Correção: Execute
source ~/.zshrcpara recarregar a configuração do shell. Se você usa Bash em vez de Zsh, substitua~/.zshrcpor~/.bash_profile. Se o erro persistir, encontre o prefixo do npm e adicione-o ao PATH:
O OpenClaw não inicia após a reinicialização
Causa: O LaunchAgent não foi instalado durante a configuração inicial.
Correção: Execute o comando de configuração inicial com a flag daemon:
Isso registra um LaunchAgent que inicia o gateway do OpenClaw automaticamente quando você faz login. Para verificar se ele está ativo:
A porta 18789 já está em uso
Causa: Outro processo está ocupando a porta do gateway.
Correção: Encontre e encerre o processo conflitante:
Erro das Xcode Command Line Tools durante a instalação de skills
Causa: Alguns pacotes npm exigem compilação nativa, e as Xcode Command Line Tools estão ausentes ou desatualizadas.
Correção: Instale ou atualize as ferramentas:
Quando a instalação terminar, tente instalar a skill novamente.
Versão do Node.js antiga demais
Causa: Seu Mac tem uma versão do Node.js anterior à 22.16 instalada. O OpenClaw requer Node 24 (recomendado) ou Node 22 LTS 22.16+.
Correção: Se você usou Homebrew:
Se você usou o instalador de uma linha, execute-o novamente. O script detectará a versão desatualizada e fará a atualização.
Conclusão
O OpenClaw pode rodar localmente no seu Mac com o instalador de uma linha ou com Homebrew, ou no navegador com o Kimi Claw, sem configuração local. Todos os métodos entregam um agent funcional, mas cada um exige um nível diferente de intervenção manual. Se você quer uma configuração mais rápida com disponibilidade 24/7 integrada, pode começar pelo Kimi Claw e colocar seu agent em funcionamento em poucos minutos.
Perguntas frequentes
openclaw onboard --install-daemon para registrar um LaunchAgent que inicia o gateway no login. Se o daemon já estiver instalado, mas não iniciar, verifique o status com launchctl list | grep openclaw e consulte os logs do sistema. Usuários do Kimi Claw não precisam dessa configuração, porque o serviço roda em servidores na nuvem e permanece online de forma independente.source ~/.zshrc para recarregar a configuração. Se o comando ainda não for encontrado, execute npm config get prefix para localizar o diretório bin e adicioná-lo ao PATH em ~/.zshrc. Reinicie o Terminal depois de fazer a alteração.sudo pmset -a sleep 0) e acesso remoto via Tailscale, ou usar o Kimi Claw. O Kimi Claw é uma plataforma totalmente gerenciada que mantém seu agent OpenClaw online o tempo todo, sem hardware para manter.curl -fsSL https://openclaw.ai/install.sh | bash. O script instala o OpenClaw, verifica sua versão do Node.js e guia você pela configuração. Você também pode usar o Homebrew: execute brew install node e depois npm install -g openclaw@latest. Para uma opção totalmente gerenciada que dispensa o terminal, o Kimi Claw executa o OpenClaw no navegador, sem configuração local.curl -fsSL https://openclaw.ai/install.sh | bash) ou instale pelo Homebrew com npm install -g openclaw@latest. Para uma opção baseada no navegador, sem download, o Kimi Claw executa o OpenClaw para você em servidores na nuvem.