--- title: "OpenClaw no Windows — Guia Completo de Instalação (2026)" url: "https://openclaw.ia.br/plataformas/windows/" markdown_url: "https://openclaw.ia.br/plataformas/windows.MD" description: "Instale OpenClaw no Windows 10/11 usando WSL2. Tutorial passo a passo: habilitar WSL, instalar Ubuntu, configurar Node.js. Inclui troubleshooting para erros comuns." date: "" author: "" --- # 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](/plataformas/docker/) 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 | 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". --- ## Instalação Passo a Passo ### Passo 1: Instalar WSL2 Abra o **PowerShell como Administrador** (clique direito → "Executar como administrador"): ```powershell 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!
### 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 ```bash sudo apt update && sudo apt upgrade -y ``` ### Passo 4: Instalar Node.js 22+ ```bash # 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 ```bash # Instalar OpenClaw globalmente npm install -g openclaw@latest # Verificar openclaw --version ``` ### Passo 6: Configurar ```bash # 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 ```bash # 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" ```powershell # 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 ```powershell # 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:** ```bash openclaw gateway start & disown ``` **Opção 3 — Usar systemd (WSL2 com Windows 11):** ```bash sudo nano /etc/systemd/system/openclaw.service ``` Veja o [guia de deploy em servidor](/blog/deploy-openclaw-vps-servidor-guia/) para configuração systemd completa. ### WhatsApp não conecta O QR code do WhatsApp funciona normalmente no WSL. Se não aparecer: ```bash # 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 ```bash # 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](https://www.docker.com/products/docker-desktop/) 2. Execute: ```bash docker run -d --name openclaw \ -v openclaw-data:/app/data \ openclaw/gateway ``` [Guia completo de Docker →](/plataformas/docker/) --- ## O Que Fazer Agora?
**Seu OpenClaw está rodando no Windows!** Agora escolha seu próximo passo:
### Conectar um Canal | Canal | Guia | |-------|------| | **WhatsApp** (mais popular) | [Configurar →](/canais/whatsapp/) | | **Telegram** | [Configurar →](/canais/telegram/) | | **Discord** | [Configurar →](/integracoes/discord/) | ### Personalizar - [Configurar SOUL.md](/tutoriais/personalizar-soul/) — Personalidade e tom - [Configurar Memória](/tutoriais/configurar-memoria/) — Contexto persistente - [Primeiro Bot Tutorial](/tutoriais/primeiro-bot/) — Passo a passo guiado ### Aprender Mais - [Instalação Geral](/instalacao/) — Guia principal com mais opções - [Todos os Tutoriais](/tutoriais/) — Aprenda com exemplos - [Skills e Receitas](/skills/) — Expanda funcionalidades --- ## Artigos Relacionados - [Deploy em VPS/Servidor](/blog/deploy-openclaw-vps-servidor-guia/) — Rodar 24/7 - [Oracle Cloud Gratuito](/blog/instalar-openclaw-gratis-oracle-cloud/) — Alternativa na nuvem - [Erros Comuns e Soluções](/blog/erros-comuns-openclaw-solucoes/) — Troubleshooting completo - [Quanto Custa Usar OpenClaw?](/blog/quanto-custa-openclaw-analise-tokens/) — Análise de custos --- ## Precisa de Ajuda?
- **Discord:** [discord.gg/clawd](https://discord.gg/clawd) — Comunidade ativa, resposta rápida - **GitHub:** [Issues](https://github.com/openclaw/openclaw/issues) — Reportar bugs - **Troubleshooting:** [Guia completo →](/troubleshooting/)