O OpenClaw é uma ferramenta local que permite que seu AI agent se conecte a apps como Telegram ou WhatsApp e realize ações, como enviar mensagens ou lidar com tarefas. A configuração é simples depois que você entende o processo. Este guia aborda a instalação no macOS, Linux e Windows.
Visão geral rápida das opções de configuração do OpenClaw
Escolha a configuração que melhor atende às suas necessidades. Executar o OpenClaw localmente mantém tudo na sua própria máquina e exige a instalação de dependências, como npm, ou o uso de um script automatizado. Se preferir pular a configuração, plataformas totalmente hospedadas como o Kimi Claw cuidam do ambiente para você, permitindo começar diretamente.
| macOS / Linux | Windows | |
|---|---|---|
| Executar localmente | Comando de Terminal em linha única | Comando PowerShell em linha única |
| Via npm | Via npm | |
| Via Homebrew | Via WSL2 | |
| Executar online | Solução baseada em nuvem (ex.: Kimi Claw) | Solução baseada em nuvem (ex.: Kimi Claw) |
Como instalar o OpenClaw no macOS e Linux
macOS e Linux usam o mesmo instalador e os mesmos comandos. Estas instruções valem para os dois sistemas, salvo indicação em contrário.
Abaixo está um guia rápido de configuração. Para um passo a passo completo com capturas de tela, consulte Como instalar o OpenClaw no macOS.
Método 1: use o script instalador de linha única
Etapa 1: execute o script de instalação no Terminal
Execute o script instalador oficial para configurar o OpenClaw. O script verifica se o Node.js 22 ou mais recente está instalado. Se ele estiver ausente ou desatualizado, o Node.js 24 será instalado automaticamente. Em seguida, ele instala a CLI do OpenClaw e inicia o assistente de onboarding.
Etapa 2: conclua o assistente de onboarding
Siga o assistente de onboarding para configurar seu ambiente de agent, incluindo selecionar um provedor de modelo (ex.: Kimi API), inserir sua chave de API, escolher um canal e definir as configurações básicas.
Etapa 3: verifique sua instalação
Execute o comando a seguir para confirmar sua versão do OpenClaw.
Etapa 4: verifique o gateway e conclua a configuração
Execute o comando a seguir para verificar se o gateway do OpenClaw está ativo.
O instalador também registra um LaunchAgent no macOS ou um serviço systemd no Linux, para que o OpenClaw continue em execução em segundo plano. Depois que tudo estiver configurado, seu agent estará pronto para uso. Você pode começar a conversar, conectar ferramentas ou configurar fluxos de trabalho conforme suas necessidades.
Método 2: instalar com Homebrew
Etapa 1: instale ou atualize o Node.js
Use o Homebrew para instalar o Node.js executando o comando a seguir no Terminal. Se o Node.js já estiver instalado, execute o comando de atualização para garantir que você esteja usando a versão mais recente.
Etapa 2: instale a CLI do OpenClaw
Execute o comando a seguir para instalar a CLI do OpenClaw globalmente.
Etapa 3: execute o onboarding e configure o daemon
Execute o comando a seguir para iniciar o assistente de onboarding e registrar o daemon em segundo plano. Siga o assistente para configurar seu ambiente de agent, incluindo selecionar um provedor de modelo (ex.: Kimi API), inserir sua chave de API e conectar um canal de mensagens. Depois que a configuração estiver concluída, seu agent estará pronto para uso. Você pode começar a conversar, conectar ferramentas ou configurar fluxos de trabalho conforme suas necessidades.
Método 3: instalar com npm
Etapa 1: verifique a versão do runtime
Execute o comando a seguir para garantir que o Node.js 22.14 ou posterior esteja instalado no seu sistema. Se a sua versão estiver atualizada, você poderá prosseguir com a instalação.
Etapa 2: instale a CLI do OpenClaw
Execute o comando a seguir para instalar a CLI do OpenClaw globalmente.
Etapa 3: execute o onboarding e habilite a persistência
Execute o comando a seguir para iniciar o assistente de onboarding e registrar o daemon em segundo plano. Siga o assistente para configurar seu ambiente de agent, incluindo selecionar um provedor de modelo (ex.: Kimi API), inserir sua chave de API e escolher um canal de mensagens. Depois que a configuração estiver concluída, seu agent estará pronto. Você pode começar a interagir com ele, conectar ferramentas ou criar fluxos de trabalho conforme suas necessidades.
Observações sobre a plataforma: O OpenClaw é compatível com Macs Intel e Apple Silicon. Se a instalação for bloqueada pelo Gatekeeper, você pode autorizá-la nos Ajustes do Sistema, em Privacidade e Segurança.
Como instalar o OpenClaw no Windows
O Windows oferece três formas principais de instalar o OpenClaw: o instalador PowerShell para uma configuração nativa rápida, o WSL2 para um ambiente Linux completo e o npm para instalação manual.
Abaixo está um guia rápido de configuração. Para um passo a passo completo com capturas de tela, consulte Como instalar o OpenClaw no Windows.
Método 1: use o instalador PowerShell (Windows nativo)
Etapa 1: execute o script instalador no PowerShell
Abra o PowerShell como administrador e execute o script oficial de linha única para instalar o OpenClaw.
Etapa 2: conclua o assistente de onboarding
Siga as etapas de onboarding para configurar seu ambiente de agent, incluindo selecionar um provedor de modelo (ex.: Kimi API), inserir sua chave de API e escolher um canal de mensagens.
Etapa 3: verifique a instalação
Execute o comando a seguir para confirmar que o OpenClaw foi instalado corretamente e que o gateway está ativo.
Etapa 4: comece a usar seu agent
Depois que a configuração estiver concluída, seu agent estará pronto. Você pode começar a interagir com ele, conectar ferramentas ou configurar fluxos de trabalho conforme suas necessidades.
Método 2: instalar com WSL2
Etapa 1: configure o ambiente Linux
Abra o PowerShell como administrador e execute o comando a seguir para habilitar e inicializar o WSL2.
Etapa 2: execute o instalador no Linux
Abra seu terminal Linux e execute o script de instalação padrão para instalar o OpenClaw.
Etapa 3: conclua o assistente de onboarding
Siga as etapas de onboarding para configurar seu ambiente de agent, incluindo selecionar um provedor de modelo (ex.: Kimi API), inserir sua chave de API e escolher um canal de mensagens.
Depois que a configuração estiver concluída, seu agent estará pronto. Você pode começar a interagir com ele, conectar ferramentas ou configurar fluxos de trabalho conforme suas necessidades.
Método 3: instalar com npm no Windows
Etapa 1: verifique sua versão do Node.js
Execute o comando a seguir para verificar se o Node.js está instalado e atualizado.
Etapa 2: instale a CLI do OpenClaw
Execute o comando a seguir para instalar a CLI do OpenClaw globalmente.
Etapa 3: execute o onboarding e habilite a persistência
Execute o comando a seguir para iniciar o assistente de onboarding e registrar o daemon em segundo plano.
Siga as etapas de onboarding para configurar seu ambiente de agent, incluindo selecionar um provedor de modelo (ex.: Kimi API), inserir sua chave de API e escolher um canal de mensagens.
Depois que a configuração estiver concluída, seu agent estará pronto. Você pode começar a interagir com ele, conectar ferramentas ou configurar fluxos de trabalho conforme suas necessidades.
Como executar o OpenClaw online com o Kimi Claw
Os métodos acima exigem um terminal, uma versão compatível do Node.js e uma máquina que permaneça ligada. O Kimi Claw oferece uma opção totalmente hospedada, para que você possa executar o OpenClaw sem instalar nem manter um ambiente local.
Etapa 1: abra o Kimi Claw e crie uma instância
Acesse a página do Kimi Claw e clique em Criar para começar.
Etapa 2: confirme a implantação
Confirme a implantação na janela pop-up. O Kimi Claw configurará automaticamente seu ambiente OpenClaw, incluindo gateway e workspace, sem exigir nenhuma configuração local.
Etapa 3: comece a usar seu workspace
Quando a implantação for concluída, seu workspace será aberto no painel. Você pode começar a interagir com seu agent, configurar skills, programar tarefas e gerenciar arquivos diretamente no navegador.
Principais recursos do Kimi Claw
Hospedagem em nuvem: O Kimi Claw executa seu gateway na nuvem, para que seu agent continue disponível mesmo quando sua máquina local estiver offline.
Manutenção automática: Atualizações e correções são aplicadas em segundo plano, sem necessidade de configuração manual nem reinicializações.
Recursos integrados: Inclui agendamento de tarefas, armazenamento persistente e carregamento dinâmico de skills com base nos seus prompts, com acesso fluido em todos os dispositivos.
Solução de problemas comuns de instalação do OpenClaw
A maioria dos problemas de instalação do OpenClaw se enquadra em algumas categorias comuns, como configuração de PATH, dependências ausentes ou conflitos de porta. As seções abaixo ajudam você a identificar e corrigir rapidamente os problemas mais frequentes no macOS, Windows e Linux.
"openclaw: command not found" após a instalação
O OpenClaw não está no PATH do seu sistema.
Correção: Adicione o diretório bin global do npm ao seu PATH.
Em seguida, recarregue seu shell (ex.: source ~/.zshrc) ou reinicie o terminal. No Windows, adicione o caminho às variáveis de ambiente e reinicie o PowerShell.
Erros de build do Sharp no macOS
Isso geralmente acontece quando um libvips instalado globalmente entra em conflito com a biblioteca Sharp.
Correção: Execute o comando de instalação com esta variável de ambiente.
Se você vir erros de node-gyp, instale o Xcode Command Line Tools:
O OpenClaw não inicia após a reinicialização
O daemon em segundo plano não foi instalado durante o onboarding.
Correção: Execute o onboarding novamente com a flag do daemon.
Em seguida, verifique o serviço:
Gateway não responde ou mostra "0 tokens used"
O processo do gateway pode ter parado, ou a autenticação da API pode ter falhado.
Correção: Reinicie o gateway.
Execute uma verificação de integridade:
Para logs de depuração:
Verifique também se sua chave de API é válida.
Porta 18789 já em uso
Outro processo está usando a porta do gateway do OpenClaw.
Correção: Encontre e interrompa o processo em conflito
Em seguida, reinicie o gateway:
Erros de permissão EACCES
Isso geralmente significa que o diretório global do npm não tem as permissões corretas.
Correção: Atualize a propriedade do diretório.
No Windows, execute o PowerShell como Administrador ou defina um prefixo npm personalizado:
Em configurações com Docker, corrija as permissões do volume:
Erro "spawn git ENOENT"
O Git não está instalado ou não está disponível no PATH.
Correção: Instale o Git em git-scm.com, reinicie o terminal e tente instalar novamente.
systemd do WSL2 não funciona
O systemd não está habilitado na sua configuração do WSL.
Correção: Edite
/etc/wsl.confe adicione.
Em seguida, reinicie o WSL:
Reabra seu terminal Linux e verifique:
Falta de memória durante npm install em VPS
Instâncias de VPS com pouca memória podem falhar durante a instalação de pacotes.
Correção: Crie um arquivo de swap.
Depois, execute a instalação novamente.
"Access not configured" ao conectar a plataformas de mensagens
Sua conta não está autorizada pelo OpenClaw.
Correção: Aprove sua conta usando o código de pareamento.
Verifique também se as credenciais do seu bot (token, webhook, permissões) estão configuradas corretamente.
Conclusão
Instalar o OpenClaw é simples no macOS, Linux e Windows. Você pode usar um script de uma linha, PowerShell, WSL2 ou npm, dependendo da sua configuração. O assistente de onboarding orienta você na escolha do modelo, na configuração da API e nos canais de mensagens. Se preferir não gerenciar um ambiente local, o Kimi Claw oferece uma opção totalmente hospedada para executar o OpenClaw diretamente na nuvem.
Perguntas frequentes
node --version para confirmar se sua versão atende ao requisito mínimo.npm install -g openclaw@latest no terminal. Isso atualiza a CLI para a versão mais recente. Você também pode executar novamente o instalador de linha única, que atualiza automaticamente sua instalação existente. O OpenClaw também oferece atualizações no próprio app pela Control UI em 127.0.0.1:18789. Depois de atualizar, reinicie o gateway com openclaw gateway restart para carregar a nova versão.openclaw gateway status para confirmar se o daemon está ativo. No Windows, o WSL2 com systemd habilitado oferece a configuração always-on mais confiável. Se você preferir não gerenciar serviços locais, opções totalmente hospedadas como o Kimi Claw permitem executar o OpenClaw continuamente na nuvem.