Instalar OpenClaw no Windows

O OpenClaw roda nativamente no Linux, mas funciona perfeitamente no Windows através do WSL2 (Windows Subsystem for Linux). Este guia mostra como configurar tudo do zero.

💡 Usando Windows 11? O processo é ainda mais simples — WSL2 já vem pré-instalado na maioria das versões.

Pré-requisitos

• Windows 10 versão 2004+ ou Windows 11
• 4GB de RAM (8GB recomendado)
• 10GB de espaço em disco
• Conexão com internet

Passo 1: Instalar WSL2

Abra o PowerShell como Administrador (clique com botão direito no menu Iniciar) e execute:

wsl --install

Esse comando instala:

• WSL2 (subsistema Linux)
• Ubuntu (distribuição padrão)

Reinicie o computador quando solicitado.

Após reiniciar

Na primeira vez que abrir o Ubuntu, você precisará criar um usuário e senha. Escolha algo simples que você lembre.

# Atualize os pacotes
sudo apt update && sudo apt upgrade -y

Passo 2: Instalar Node.js

Dentro do terminal Ubuntu/WSL2:

# Instalar Node.js via nvm (recomendado)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Reiniciar terminal ou executar:
source ~/.bashrc

# Instalar Node.js LTS
nvm install --lts

Verifique a instalação:

node --version  # Deve mostrar v20.x ou superior
npm --version   # Deve mostrar 10.x ou superior

Passo 3: Instalar OpenClaw

Agora sim, instale o OpenClaw:

npm install -g openclaw@latest

Execute o wizard de configuração:

openclaw onboard --install-daemon

O wizard vai guiar você para:

1. Escolher seu provedor de IA (OpenAI, Anthropic, etc.)
2. Configurar suas chaves de API
3. Conectar um canal (WhatsApp, Telegram, Discord)

Passo 4: Manter OpenClaw Rodando

Para manter o OpenClaw rodando em segundo plano:

# Iniciar o daemon
openclaw gateway start

# Ver status
openclaw gateway status

# Parar
openclaw gateway stop

Iniciar automaticamente com Windows

Crie um script que inicia o OpenClaw quando você logar:

1. Pressione Win + R e digite shell:startup
2. Crie um arquivo openclaw.vbs com:

Set WshShell = CreateObject("WScript.Shell")
WshShell.Run "wsl -d Ubuntu -e bash -c 'openclaw gateway start'", 0

Troubleshooting Windows

Erro: “WSL não está habilitado”

Execute no PowerShell como Admin:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Reinicie e tente novamente.

Erro: “Virtualização não habilitada”

Você precisa habilitar virtualização na BIOS:

1. Reinicie o PC
2. Entre na BIOS (geralmente F2, Del ou F10 durante boot)
3. Procure “Virtualization Technology” ou “Intel VT-x” / “AMD-V”
4. Habilite e salve

Erro: “npm EACCES permission denied”

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest

WSL usando muita memória

Crie o arquivo %USERPROFILE%\.wslconfig:

[wsl2]
memory=4GB
processors=2

Reinicie WSL: wsl --shutdown

Acessando Arquivos

• Windows → WSL: Seus arquivos Windows estão em /mnt/c/Users/SeuUsuario/
• WSL → Windows: Acesse \\wsl$\Ubuntu\home\seuusuario\ no Explorer

O workspace do OpenClaw fica em ~/clawd/ dentro do WSL.

Próximos Passos

Agora que o OpenClaw está instalado:

1. Configure seu primeiro bot - Crie um assistente básico
2. Personalize a personalidade - Edite o SOUL.md
3. Conecte ao WhatsApp - Atenda clientes automaticamente
4. Explore as Skills - Adicione funcionalidades prontas

Artigos Relacionados

• Instalação no macOS
• Instalação no Linux
• Deploy na Oracle Cloud (Grátis)
• Troubleshooting Geral