---
title: "Instalar OpenClaw no Windows: Guia Completo 2026"
url: "https://openclaw.ia.br/instalacao/windows.md"
markdown_url: "https://openclaw.ia.br/instalacao/windows.md"
description: "Passo a passo para instalar o OpenClaw no Windows 10/11 usando WSL2. Inclui troubleshooting para erros comuns e configuração do ambiente."
---

# Instalar OpenClaw no Windows: Guia Completo 2026

Passo a passo para instalar o OpenClaw no Windows 10/11 usando WSL2. Inclui troubleshooting para erros comuns e configuração do ambiente.


# Instalar OpenClaw no Windows

<div class="badges">
⏱ <strong>10 minutos</strong> ·  <strong>Iniciante</strong> ·  <strong>Windows 10/11</strong>
</div>

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:

```powershell
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.

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

---

## Passo 2: Instalar Node.js

Dentro do terminal Ubuntu/WSL2:

```bash
# 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:

```bash
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:

```bash
npm install -g openclaw@latest
```

Execute o wizard de configuração:

```bash
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:

```bash
# 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:

```vbscript
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:

```powershell
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"

```bash
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`:

```ini
[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](/tutoriais/primeiro-bot/)** - Crie um assistente básico
2. **[Personalize a personalidade](/tutoriais/personalizar-soul/)** - Edite o SOUL.md
3. **[Conecte ao WhatsApp](/tutoriais/whatsapp/)** - Atenda clientes automaticamente
4. **[Explore as Skills](/skills/)** - Adicione funcionalidades prontas

---

## Artigos Relacionados

- [Instalação no macOS](/instalacao/macos/)
- [Instalação no Linux](/instalacao/linux/)
- [Deploy na Oracle Cloud (Grátis)](/blog/instalar-openclaw-gratis-oracle-cloud/)
- [Troubleshooting Geral](/troubleshooting/)