Como instalar o OpenClaw no Windows

O OpenClaw é uma ferramenta poderosa para criar fluxos de trabalho de IA, mas configurá-lo no Windows pode ser confuso para iniciantes. Este guia apresenta os principais métodos de instalação para você começar rapidamente.

Instalação do OpenClaw no Windows: comparação de 3 métodos

Antes de mergulhar nas etapas, veja um breve panorama das três maneiras de instalar o OpenClaw no Windows. Cada método tem diferentes prós e contras em termos de tempo de configuração, cobertura de recursos e requisitos técnicos.

Kimi Claw é uma ferramenta online que permite executar o OpenClaw no navegador. Ela cuida automaticamente da instalação e da configuração, então você não precisa de Node.js, WSL nem configurar chave de API. Em poucos minutos, você começa a usar um agent pronto para uso.

Para uma configuração local com PowerShell ou WSL2, role até o Método 1 ou o Método 2. Para pular totalmente a instalação local, vá para o Método 3: Kimi Claw. Se quiser começar mais rápido, você pode iniciar agora mesmo.

O que você precisa antes de instalar o OpenClaw localmente no Windows

Se pretende instalar o OpenClaw localmente, verifique se seu sistema atende aos requisitos abaixo. Se optar por uma solução na nuvem como Kimi Claw, você pode pular esta seção inteira.

Requisitos do sistema

• Windows 10 ou Windows 11 (64 bits)

• Pelo menos 4 GB de RAM (8 GB recomendados para compilações npm estáveis)

• Conexão estável com a internet

• Privilégios de administrador para a configuração inicial, caso escolha WSL2

• Para OpenClaw WSL2: a virtualização deve estar habilitada no BIOS/UEFI

Software necessário

• Node.js 22.14 ou superior. O OpenClaw exige um runtime Node.js moderno. Baixe em nodejs.org ou instale pelo script de onboarding.

• Git for Windows (opcional, mas recomendado). Alguns pacotes npm e skills dependem do Git.

Método 1: instalar o OpenClaw no Windows usando PowerShell

Em comparação com o WSL2, o método via PowerShell exige menos etapas e dispensa um ambiente Linux. Um único comando baixa o OpenClaw, verifica sua versão do Node.js e inicia o assistente de onboarding. Esse método funciona tanto no Windows 10 quanto no Windows 11.

Etapa 1: instale e execute seu OpenClaw

Por padrão, o Windows restringe a execução de scripts para proteger o sistema. Antes de instalar o OpenClaw, é preciso permitir que o PowerShell execute scripts locais rodando este comando de “chave de segurança”:

Em seguida, execute o comando abaixo:

Depois de executar o comando, você deverá ver uma saída semelhante à captura de tela abaixo. Feche e reabra o PowerShell para atualizar o PATH do sistema antes de prosseguir para o onboarding.

Etapa 2: confirme o aviso de risco e selecione o modo de onboarding

Selecione Yes para reconhecer o risco e continuar.

Em seguida, selecione QuickStart para iniciar rapidamente o onboarding. Você pode ajustar as configurações depois ou escolher Manual para fazer a configuração completa.

Etapa 3: configure e autentique seu modelo de IA

1. Selecione Moonshot AI como provedor de modelo/autenticação

1. Autentique e configure seu modelo de IA

Para conectar o OpenClaw, ative sua Kimi API Key pela Plataforma Aberta Kimi. Embora uma recarga de US$5 renda um voucher bônus de US$ 5, recomendamos US$ 20 ou mais para liberar o acesso ao Tier 2. Isso reduz a latência e garante que seu agent OpenClaw lide com tarefas complexas e em várias etapas.

1. Crie uma chave de API Kimi

Acesse a seção API Keys e clique em Create API Key. Guarde sua API Key em um local seguro e de fácil acesso. Ela só é exibida uma vez, no momento da criação.

1. Insira sua chave de API e selecione o modelo padrão

Quando o assistente de onboarding solicitar, cole sua chave de API exclusiva na janela do PowerShell/Terminal.

Quando for solicitado que você escolha um modelo padrão, selecione moonshot/kimi-k2.5 (ou escolha "Keep current" se ele já estiver destacado). Esse modelo oferece o melhor equilíbrio entre velocidade e raciocínio para tarefas agentic.

Etapa 4: selecione o canal

Escolha qual aplicativo você deseja conectar ao seu OpenClaw. Se não souber, basta pular esta etapa.

Etapa 5: configure o desempenho

Clique em Yes para configurar ou em No para pular.

Etapa 6: habilite Hooks

Escolha um método para conversar com seu bot e aguarde até que ele comece a executar.

Etapa 7: execute seu OpenClaw

Depois de concluir tudo acima, aproveite seu OpenClaw.

Método 2: instalar o OpenClaw no Windows com WSL2

A configuração do OpenClaw com WSL2 oferece um ambiente Linux completo dentro do Windows, que é a forma oficialmente recomendada de executar o OpenClaw. Esse método dá acesso ao conjunto completo de recursos, incluindo gerenciamento de daemon com systemd, scripts de shell nativos e compilações npm mais estáveis. Se você pretende usar o OpenClaw no Windows em fluxos de trabalho diários ou desenvolvimento, o OpenClaw WSL é a melhor escolha.

Etapa 1: habilite o WSL2 para o OpenClaw no Windows 11/10

Abra o PowerShell como Administrador e execute:

Esse comando habilita o WSL, baixa o Ubuntu e faz a instalação. Quando o processo terminar, reinicie o computador. Ao reiniciar o Windows, o Ubuntu será aberto e pedirá que você crie um nome de usuário e uma senha.

Se você já tem o WSL instalado, verifique:

Etapa 2: configure o WSL2 para o systemd

O OpenClaw é executado como serviço em segundo plano usando systemd. Habilite-o na configuração do WSL:

Em seguida, reinicie o WSL pelo PowerShell:

Reabra o terminal do Ubuntu e verifique se o systemd está em execução:

A saída deve mostrar systemd. Se mostrar init, confira novamente o arquivo /etc/wsl.conf.

Etapa 3: instale o Node.js 22.14+

O OpenClaw requer Node.js 22.14 ou posterior. Instale-o pelo repositório NodeSource:

Verifique a instalação:

Etapa 4: instale o OpenClaw via npm

Com o Node.js pronto, instale o OpenClaw globalmente:

Como alternativa, use o script de instalação oficial:

Verifique a instalação:

Etapa 5: conclua a configuração do OpenClaw no Windows via onboarding

Execute o assistente de onboarding usando a flag de daemon para configurar o OpenClaw como serviço systemd:

O assistente orientará você a:

• Selecionar seu provedor de LLM e inserir sua chave de API

• Escolher um modelo padrão

• Configurar canais de mensagens (opcional)

• Instalar o gateway como serviço em segundo plano

Após o onboarding, habilite a persistência do serviço para que o OpenClaw inicie automaticamente quando o WSL for inicializado:

O gateway é o serviço principal em segundo plano que lida com todas as operações do OpenClaw, incluindo solicitações do agent, mensagens e execução de modelos. Garantir que ele esteja em execução confirma que a instalação do OpenClaw está completa e pronta para uso, além de evitar erros nas etapas seguintes.

Execute o comando abaixo no PowerShell ou no terminal WSL para verificar o status:

Método 3: execute o OpenClaw no Windows com Kimi Claw (sem configuração necessária)

Se gerenciar Node.js, WSL e chaves de API parecer configuração demais para o que você precisa, Kimi Claw oferece uma forma mais simples de executar o OpenClaw. Ele permite executar o OpenClaw diretamente no navegador, sem configuração local nem ajustes manuais. Para começar, siga estas etapas:

Etapa 1: abra o Kimi Claw e crie uma instância

Acesse a página do Kimi Claw e clique em Create para começar.

Etapa 2: inicie a implantação

Confirme a implantação no pop-up. O Kimi Claw configura seu ambiente OpenClaw em cerca de dois minutos, incluindo gateway, workspace e ferramentas. Nenhum comando ou configuração manual é necessário.

Etapa 3: trabalhe no seu workspace

Quando a implantação terminar, seu workspace será aberto no painel. Você poderá conversar com seu agent de IA, configurar skills, definir tarefas agendadas e gerenciar arquivos, tudo pelo navegador.

O que você ganha com o Kimi Claw

• Configuração zero: sem necessidade de Node.js, WSL ou gerenciamento de chaves de API

• 40 GB de armazenamento em nuvem: salve relatórios, conjuntos de dados e arquivos gerados que permanecem entre sessões

• Memória persistente: seu agent de IA lembra interações anteriores, preferências e contexto

• Mais de 5.000 skills do ClawHub: acesse instantaneamente skills de automação, pesquisa, programação e análise

• Automação de tarefas agendadas: configure tarefas recorrentes, como relatórios diários, lembretes e monitoramento

• Funciona em qualquer dispositivo: acesse seu agent OpenClaw de qualquer navegador no Windows, Mac ou celular

Firewall do Windows e configurações de segurança para o OpenClaw

O Kimi Claw cuida automaticamente da segurança e da rede nos servidores em nuvem. Se você preferir instalar o OpenClaw localmente com PowerShell ou WSL2, recomendamos ajustar algumas configurações de segurança após a instalação.

• Configurando o Windows Firewall

Quando o gateway do OpenClaw for iniciado pela primeira vez, o Windows Firewall poderá pedir que você permita o acesso à rede. Permita apenas em redes privadas. Se estiver usando o OpenClaw WSL2, o gateway roda dentro do ambiente Linux e se comunica por localhost, portanto regras adicionais de firewall geralmente não são necessárias.

Se o Browser Relay ou outros recursos não conseguirem se conectar, verifique se o tráfego de localhost não está sendo bloqueado por softwares de segurança de terceiros, como antivírus, clientes VPN ou firewalls corporativos.

• Protegendo a Control UI

A Control UI do OpenClaw é executada na porta 18789 e oferece acesso completo ao seu agent. Nunca exponha essa porta à internet pública. Mantenha o gateway vinculado a 127.0.0.1 e acesse-o apenas pela sua máquina local.

Para acesso remoto seguro, use Tailscale para criar um túnel de rede privada:

Isso mantém a porta em localhost, ao mesmo tempo que a torna acessível pela sua rede privada Tailscale.

Erros comuns de instalação do OpenClaw no Windows e como corrigi-los

Mesmo com um guia claro, problemas podem surgir durante a instalação. Veja abaixo os erros mais relatados ao instalar o OpenClaw no Windows e como corrigi-los.

OpenClaw não é reconhecido

• Causa: o diretório bin global do npm não está no PATH do sistema.

• Correção: execute o comando abaixo para encontrar o prefixo do npm

Adicione o caminho exibido às variáveis de ambiente do Windows. Não acrescente \\bin. Depois, feche e reabra o PowerShell.

Git não encontrado durante a instalação

• Causa: Git for Windows não está instalado.

• Correção: baixe e instale o Git em git-scm.com. Após a instalação, reinicie o PowerShell e tente novamente o instalador do OpenClaw para Windows.

A versão do Node.js é antiga demais

• Causa: seu sistema tem uma versão mais antiga do Node.js que não atende ao requisito mínimo (v22.14+).

• Correção: baixe a versão LTS mais recente em nodejs.org e instale-a. Se estiver usando OpenClaw WSL2, reinstale pelo repositório NodeSource.

Erros de permissão negada

• Causa: o PowerShell não tem permissões suficientes, ou o diretório global do npm não permite gravação.

• Correção: execute o PowerShell como Administrador ou altere o prefixo global do npm para um diretório com permissão de gravação pelo usuário

O gateway não inicia

• Causa: a Port 18789 já está em uso, ou o arquivo de configuração está corrompido.

• Correção: verifique se há processos em conflito e reinicie

O systemd do WSL2 não está funcionando

• Causa: o arquivo /etc/wsl.conf não contém a configuração de systemd.

• Correção: verifique se o arquivo contém as configurações corretas

Se a configuração estiver ausente, adicione-a e reinicie o WSL com wsl --shutdown no PowerShell.

Conclusão

Instalar o OpenClaw no Windows pode variar de uma configuração simples baseada em script a um ambiente WSL2 mais avançado, dependendo das suas necessidades. Se você busca controle total e flexibilidade, PowerShell e WSL2 são ótimas opções. Se preferir pular a configuração e começar imediatamente, o Kimi Claw permite executar o OpenClaw no navegador, sem instalação local. Escolha a abordagem que melhor se ajusta ao seu fluxo de trabalho e ao seu nível de familiaridade técnica, e você estará pronto para aproveitar ao máximo o OpenClaw.