OpenClaw no Windows — Guia Completo de Instalação (2026)
Instale OpenClaw no Windows 10/11 usando WSL2. Tutorial passo a passo: habilitar WSL, instalar Ubuntu, configurar Node.js. Inclui troubleshooting para erros comuns.
OpenClaw no Windows
⏱️ Tempo: 15-20 minutos · 🎯 Nível: Iniciante · 💻 Windows 10 ou 11
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.
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
| Requisito | Mínimo | Recomendado |
|---|---|---|
| Windows | 10 versão 2004+ | 11 |
| RAM | 4GB | 8GB+ |
| Disco | 10GB livres | 20GB+ |
| Virtualização | Habilitada na BIOS | ✓ |
💡 Verificar virtualização: Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) → Desempenho → CPU. Procure “Virtualização: Habilitado”.
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.
⚠️ Primeiro uso: Após reiniciar, o Ubuntu abrirá automaticamente e pedirá para criar usuário e senha. Guarde essa senha — você vai precisar dela!
Após criar o usuário, você pode abrir o Ubuntu de duas formas:
- Menu Iniciar → Digite “Ubuntu” → Clique no ícone
- Windows Terminal → Nova aba → Ubuntu
sudo apt update && sudo apt upgrade -y
# 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
# Instalar OpenClaw globalmente
npm install -g openclaw@latest
# Verificar
openclaw --version
# Executar wizard de configuração
openclaw onboard --install-daemon
O wizard vai pedir:
- API Key (Anthropic ou OpenAI)
- Modelo padrão (Claude ou GPT-4)
- Canal (WhatsApp, Telegram, etc.)
# Verificar status
openclaw gateway status
# Ver logs
openclaw gateway logs -f
Envie uma mensagem para seu bot! Se responder, está funcionando. 🎉
# No PowerShell como Admin:
wsl --update
Você precisa habilitar na BIOS:
- Reinicie o PC
- Entre na BIOS (geralmente F2, F12, ou DEL durante boot)
- Procure “Virtualization Technology”, “VT-x”, “AMD-V”, ou “SVM”
- Habilite e salve
# 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
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.
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
Seus arquivos do OpenClaw ficam em ~/clawd/ dentro do Ubuntu.
Para acessar do Windows Explorer:
\\wsl$\Ubuntu\home\SEU_USUARIO\clawd\
Instale o Windows Terminal da Microsoft Store — muito melhor que o terminal padrão.
# Abrir pasta no VS Code direto do WSL
code ~/clawd
O VS Code detecta automaticamente e instala a extensão WSL.
Se preferir não usar WSL diretamente:
- Instale Docker Desktop
- Execute:
docker run -d --name openclaw \
-v openclaw-data:/app/data \
openclaw/gateway
Seu OpenClaw está rodando no Windows! 🎉
Agora escolha seu próximo passo:
| Canal | Guia |
|---|---|
| WhatsApp (mais popular) | Configurar → |
| Telegram | Configurar → |
| Discord | Configurar → |
- Configurar SOUL.md — Personalidade e tom
- Configurar Memória — Contexto persistente
- Primeiro Bot Tutorial — Passo a passo guiado
- Instalação Geral — Guia principal com mais opções
- Todos os Tutoriais — Aprenda com exemplos
- Skills e Receitas — Expanda funcionalidades
- Deploy em VPS/Servidor — Rodar 24/7
- Oracle Cloud Gratuito — Alternativa na nuvem
- Erros Comuns e Soluções — Troubleshooting completo
- Quanto Custa Usar OpenClaw? — Análise de custos
- Discord: discord.gg/clawd — Comunidade ativa, resposta rápida
- GitHub: Issues — Reportar bugs
- Troubleshooting: Guia completo →
Seu OpenClaw está instalado no Windows! Agora configure em 15 minutos:
- 📋 Pós-Instalação: 7 Passos Essenciais → — Configure memória, personalidade e permissões
- 📱 Conectar WhatsApp em 30 segundos → — O canal mais popular
- 🤖 Criar Primeiro Bot → — Tutorial guiado de 10 minutos
- Configurar SOUL.md (personalidade) — 5 min
- Rodar 24/7 na Oracle Cloud (grátis) — Seu PC pode desligar
- Usar Modelos Locais com Ollama — Custo zero de API
- Automação WhatsApp para Empresas — Atenda clientes 24/7