OpenClaw no Windows: como instalar com WSL2

Resposta direta: para instalar o OpenClaw no Windows 10 ou 11, abra o PowerShell como administrador, execute wsl --install -d Ubuntu, reinicie o computador e instale Node.js 22 dentro do Ubuntu. Depois rode npm install -g openclaw@latest e openclaw onboard --install-daemon. O caminho recomendado usa WSL2 e leva cerca de 15 minutos.

O OpenClaw roda no Windows através do WSL2 (Windows Subsystem for Linux) — uma camada que permite executar Linux nativamente no Windows, sem precisar de máquina virtual pesada.

Não quer usar WSL? Também funciona com Docker Desktop se preferir containers.

Por Que WSL2?

O WSL2 é a forma recomendada porque:

• ✅ Roda Linux nativamente (não é emulação)
• ✅ Performance quase igual a Linux nativo
• ✅ Acessa arquivos do Windows facilmente
• ✅ Integra com Windows Terminal
• ✅ Suporte oficial da Microsoft

Pré-requisitos

Verificar virtualização: Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) → Desempenho → CPU. Procure “Virtualização: Habilitado”.

Como instalar OpenClaw no Windows passo a passo

Passo 1: Instalar WSL2

Abra o PowerShell como Administrador (clique direito → “Executar como administrador”):

wsl --install

Isso instala automaticamente:

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

Reinicie o computador quando solicitado.

Passo 2: Abrir Ubuntu

Após criar o usuário, você pode abrir o Ubuntu de duas formas:

1. Menu Iniciar → Digite “Ubuntu” → Clique no ícone
2. Windows Terminal → Nova aba → Ubuntu

Passo 3: Atualizar o Sistema

sudo apt update && sudo apt upgrade -y

Passo 4: Instalar Node.js 22+

# Adicionar repositório NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# Instalar Node.js
sudo apt install -y nodejs

# Verificar instalação
node --version   # Deve mostrar v22.x.x
npm --version    # Deve mostrar 10.x.x

Passo 5: Instalar OpenClaw

# Instalar OpenClaw globalmente
npm install -g openclaw@latest

# Verificar
openclaw --version

Passo 6: Configurar

# Executar wizard de configuração
openclaw onboard --install-daemon

O wizard vai pedir:

1. API Key (Anthropic ou OpenAI)
2. Modelo padrão (Claude ou GPT-4)
3. Canal (WhatsApp, Telegram, etc.)

Passo 7: Testar

# Verificar status
openclaw gateway status

# Ver logs
openclaw gateway logs -f

Envie uma mensagem para seu bot! Se responder, está funcionando.

Troubleshooting

Erro: “WSL 2 requires an update”

# No PowerShell como Admin:
wsl --update

Erro: “Virtualização desabilitada”

Você precisa habilitar na BIOS:

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

Erro: “0x80370102” ou similar

# Habilitar recursos Windows manualmente:
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

OpenClaw não inicia após fechar terminal

O gateway precisa continuar rodando. Soluções:

Opção 1 — Manter terminal aberto: Use Windows Terminal com Ubuntu em aba separada.

Opção 2 — Rodar em background:

openclaw gateway start &
disown

Opção 3 — Usar systemd (WSL2 com Windows 11):

sudo nano /etc/systemd/system/openclaw.service

Veja o guia de deploy em servidor para configuração systemd completa.

WhatsApp não conecta

O QR code do WhatsApp funciona normalmente no WSL. Se não aparecer:

# Limpar sessão e tentar novamente
rm -rf ~/.openclaw/whatsapp-session
openclaw gateway restart

Dicas de Uso

Acessar Arquivos

Seus arquivos do OpenClaw ficam em ~/clawd/ dentro do Ubuntu.

Para acessar do Windows Explorer:

\\wsl$\Ubuntu\home\SEU_USUARIO\clawd\

Melhor Terminal

Instale o Windows Terminal da Microsoft Store — muito melhor que o terminal padrão.

Integração com VS Code

# Abrir pasta no VS Code direto do WSL
code ~/clawd

O VS Code detecta automaticamente e instala a extensão WSL.

Alternativa: Docker Desktop

Se preferir não usar WSL diretamente:

1. Instale Docker Desktop
2. Execute:

docker run -d --name openclaw \
  -v openclaw-data:/app/data \
  openclaw/gateway

Guia completo de Docker →

O Que Fazer Agora?

Conectar um Canal

Personalizar

• Configurar SOUL.md — Personalidade e tom
• Configurar Memória — Contexto persistente
• Primeiro Bot Tutorial — Passo a passo guiado

Aprender Mais

• Instalação Geral — Guia principal com mais opções
• Todos os Tutoriais — Aprenda com exemplos
• Skills e Receitas — Expanda funcionalidades

Artigos Relacionados

• Deploy em VPS/Servidor — Rodar 24/7
• Oracle Cloud Gratuito — Alternativa na nuvem
• Erros comuns na instalação do OpenClaw — Troubleshooting completo
• Quanto Custa Usar OpenClaw? — Análise de custos

Perguntas frequentes sobre OpenClaw no Windows

O OpenClaw funciona no Windows 10 e no Windows 11?

Sim. O OpenClaw funciona no Windows 10 versão 2004 ou mais recente e no Windows 11 por meio do WSL2. O Windows 11 costuma oferecer a experiência mais simples porque traz integração melhor com WSL, Windows Terminal e systemd.

Preciso usar WSL2 para instalar o OpenClaw no Windows?

O WSL2 é o caminho recomendado porque reproduz o ambiente Linux usado pelo OpenClaw e facilita suporte, atualizações e diagnóstico. Quem prefere containers pode usar Docker Desktop, mas ele também utiliza a virtualização do Windows e adiciona outra camada de configuração.

Como instalar OpenClaw no Windows 11?

Abra o PowerShell como administrador, rode wsl --install -d Ubuntu e reinicie o computador. No Ubuntu, instale Node.js 22 ou superior, execute npm install -g openclaw@latest e finalize com openclaw onboard --install-daemon.

O OpenClaw tem aplicativo nativo para Windows?

A operação principal acontece dentro do WSL2, enquanto você pode acessar arquivos pelo Explorador do Windows, usar o Windows Terminal e editar a pasta do agente com VS Code. Para entender as opções de aplicativo e acesso móvel, consulte a página de apps do OpenClaw.

O que fazer se o comando openclaw não for encontrado?

Feche e reabra o terminal Ubuntu, confirme a instalação com npm list -g --depth=0 e verifique se a pasta global do npm está no PATH. Rode também openclaw doctor; o guia de erros comuns na instalação cobre permissões, versões do Node.js e problemas de gateway.

Precisa de Ajuda?