OpenClaw no Windows

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”.

Instalação 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 e Soluções — Troubleshooting completo
• Quanto Custa Usar OpenClaw? — Análise de custos

Precisa de Ajuda?