Guia de configuração do OpenClaw para Windows: instalar no Windows 10 e 11

Introdução

OpenClaw funciona muito bem no Windows, embora o processo de instalação seja um pouco diferente do macOS e Linux. Este guia cobre tudo que você precisa para instalar e executar o OpenClaw no Windows 10 ou Windows 11, incluindo configuração do PowerShell, instalação do Node.js e recomendações WSL2.

Para obter instruções gerais de instalação, consulte nosso guia completo de instalação.

Requisitos do sistema

Versão Windows

• Windows 10 (versão 1903 ou posterior)
• Windows 11 (todas as versões)
• Versões mais antigas podem funcionar, mas não são oficialmente suportadas

Hardware

• RAM — 2 GB+ recomendado (4 GB+ para melhor desempenho)
• Armazenamento — 500 MB+ para instalação, espaço adicional para memória/dados
• Processador — Qualquer processador x64 moderno

Pré-requisitos de software

• Node.js 18+ — Necessário para executar o OpenClaw
• PowerShell 5.1+ ou Windows Terminal — Recomendado em vez de CMD
• Git (opcional) — Para instalação hackeável a partir do código-fonte

Métodos de instalação

Método 1: instalação npm (recomendado)

A maneira padrão de instalar o OpenClaw no Windows:

1. Instale o Node.js (se ainda não estiver instalado):

   • Baixe em nodejs.org
   • Escolha a versão LTS (18.x ou superior)
   • Execute o instalador com configurações padrão
   • Verifique a instalação:

     node --version
     npm --version

2. Instale o OpenClaw:

   npm i -g openclaw

3. Verifique a instalação:

   openclaw --version

Método 2: PowerShell One-Liner

Um script do PowerShell automatiza a instalação:

irm https://openclaw.ai/install.ps1 | iex

Observação: Talvez seja necessário ativar a execução do script:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Este script irá:

• Verifique se há Node.js (solicite a instalação se estiver faltando)
• Instale o OpenClaw globalmente
• Configure PATH se necessário
• Verifique a instalação

Método 3: instalação WSL2 (melhor experiência)

O Windows Subsystem for Linux 2 (WSL2) fornece um ambiente Linux que geralmente funciona melhor para OpenClaw:

1. Instale WSL2:

   wsl --install

   Reinicie o seu computador quando solicitado.

2. Instale o Ubuntu (ou sua distribuição Linux preferida):

   wsl --install -d Ubuntu

3. Dentro do WSL2, instale o OpenClaw:

   curl -fsSL https://openclaw.ai/install.sh | bash

WSL2 fornece:

• Melhor compatibilidade com ferramentas Unix
• Desempenho nativo do Linux
• Integração mais fácil com serviços baseados em Linux
• Acesso a gerenciadores de pacotes Linux

Consulte nosso guia de configuração do Linux para obter instruções específicas do WSL2.

Método 4: instalação hackeável (da fonte)

Para desenvolvedores que desejam modificar a fonte:

1. Instale o Git:

   • Baixe em git-scm.com
   • Ou instale via winget:

     winget install Git.Git

2. Clone e construa:

   git clone https://github.com/openclaw/openclaw.git
   cd openclaw
   npm install
   npm run build

3. Executar a partir da fonte:

   npm run openclaw onboard

Instalando Node.js no Windows

Opção 1: Instalador Oficial

1. Visite nodejs.org
2. Baixe a versão LTS (18.x ou superior)
3. Execute o instalador
4. Marque “Adicionar ao PATH” durante a instalação
5. Verifique:

   node --version
   npm --version

Opção 2: winget (Gerenciador de Pacotes do Windows)

winget install OpenJS.NodeJS.LTS

Opção 3: Chocolate

Se você tiver o Chocolatey instalado:

choco install nodejs-lts

Opção 4: Colher

Se você usar o Scoop:

scoop install nodejs-lts

PowerShell versus prompt de comando

PowerShell (recomendado)

PowerShell é mais poderoso e moderno:

• Melhores capacidades de script
• Mais consistente com comandos de plataforma cruzada
• Melhor tratamento de erros
• Suporte JSON nativo

Use o PowerShell para todos os comandos do OpenClaw.

Prompt de Comando (CMD)

O CMD funciona, mas tem limitações:

• Sintaxe mais antiga
• Scripts menos poderosos
• Alguns scripts npm podem não funcionar corretamente

Se você precisar usar o CMD, os comandos serão basicamente os mesmos, mas o PowerShell é recomendado.### Terminal do Windows

O Terminal do Windows oferece a melhor experiência:

• Várias guias
• Melhor renderização de fontes
• Aparência personalizável
• PowerShell, CMD e WSL integrados

Instale da Microsoft Store ou:

winget install Microsoft.WindowsTerminal

Configuração pós-instalação

Após a instalação, configure o OpenClaw:

openclaw onboard

Esta configuração interativa abrange:

1. Configuração do modelo de IA

Escolha seu provedor de IA:

Claude Anthropic:

• Soneto Claude 3.5 (recomendado)
• Claude 3 Opus
• Cláudio 4

Obtenha sua chave de API em console.anthropic.com.

OpenAI GPT:

• GPT-4o
• GPT-4 Turbo
• GPT-4.1

Obtenha sua chave de API em platform.openai.com.

Modelos locais:

• Ollama (executado localmente)
• Estúdio LM
• MiniMax

2. Permissões do Windows

OpenClaw pode solicitar permissões:

• Firewall — Permitir Node.js/OpenClaw através do Firewall do Windows
• Antivírus — Pode ser necessário colocar o diretório OpenClaw na lista de permissões
• Sistema de arquivos — Para leitura/gravação de arquivos

3. Configuração do PATH

Certifique-se de que o OpenClaw esteja em seu PATH:

$env:PATH -split ';' | Select-String "npm"

Se não for encontrado, adicione o caminho global npm:

$npmPath = npm config get prefix
$env:PATH += ";$npmPath"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

Reinicie o PowerShell após modificar o PATH.

Executando o OpenClaw

Inicie o servidor

openclaw

Isso inicia o servidor local e conecta todas as integrações configuradas.

Executar em segundo plano

Utilize Start-Process:

Start-Process -NoNewWindow openclaw

Ou use um gerenciador de processos como pm2:

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

Executar como serviço do Windows

Instale como um serviço do Windows usando node-windows:

npm i -g node-windows

Crie um script de serviço (consulte documentação do node-windows).

Lançamento na inicialização

Crie uma tarefa agendada:

1. Abra o Agendador de Tarefas
2. Crie uma tarefa básica
3. Nome: “OpenClaw”
4. Acionador: “Quando eu fizer logon”
5. Ação: “Iniciar um programa”
6. Programa: C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd
7. Argumentos: (deixe em branco)

Ou use a pasta Inicialização:

$startup = [Environment]::GetFolderPath("Startup")
$shortcut = "$startup\OpenClaw.lnk"
$shell = New-Object -ComObject WScript.Shell
$link = $shell.CreateShortcut($shortcut)
$link.TargetPath = "C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd"
$link.Save()

Considerações específicas do Windows

Software antivírus

Alguns softwares antivírus podem sinalizar o OpenClaw:

• Windows Defender — Geralmente funciona bem, pode precisar de exclusão
• AV de terceiros — Pode exigir lista de permissões

Adicionar exclusão para:

• Diretório de instalação do OpenClaw
• ~/.openclaw diretório de dados
• Executável Node.js.

Configuração de Firewall

Permitir OpenClaw através do Firewall do Windows:

New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -Program "C:\Users\YourName\AppData\Roaming\npm\node_modules\openclaw\bin\openclaw.js" -Action Allow

Ou use a GUI do Firewall do Windows Defender:

1. Segurança do Windows → Firewall e proteção de rede
2. Permitir um aplicativo através do firewall
3. Adicione OpenClaw

Suporte para caminho longo

O Windows tem um limite de caminho de 260 caracteres. Habilite caminhos longos:

1. Abra o Editor de Política de Grupo (gpedit.msc)
2. Navegue para: Configuração do Computador → Modelos Administrativos → Sistema → Sistema de Arquivos
3. Ative “Ativar caminhos longos do Win32”
4. Reinicie o computador

Ou edite o registro (somente usuários avançados).

Finais de linha

O Windows usa CRLF, o Unix usa LF. A maioria das ferramentas lida com isso automaticamente, mas se você encontrar problemas:

git config --global core.autocrlf true

Solução de problemas

Comando não encontrado

Se openclaw não for reconhecido:

1. Verifique o caminho global do npm:

   npm config get prefix

2. Adicionar ao PATH:

   $npmPath = npm config get prefix
   [Environment]::SetEnvironmentVariable("Path", "$env:Path;$npmPath", [EnvironmentVariableTarget]::User)

3. Reinicie o PowerShell

4. Verifique:

   Get-Command openclaw

Permissão negada

Se você vir erros de permissão:

1. Execute o PowerShell como administrador: Clique com o botão direito em PowerShell → “Executar como administrador”

2. Instalar globalmente:

   npm i -g openclaw

3. Corrigir permissões npm (alternativa):

   mkdir $env:APPDATA\npm-global
   npm config set prefix "$env:APPDATA\npm-global"
   $env:PATH += ";$env:APPDATA\npm-global"
   [Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

Porta já em uso

Altere a porta:

openclaw --port 3001

Ou encontre e elimine o processo:

netstat -ano | findstr :3000
taskkill /PID <PID> /F

Problemas de versão do Node.js

Certifique-se de ter o Node.js 18+:

node --version

Se estiver desatualizado, atualize:

winget upgrade OpenJS.NodeJS.LTS
```Ou baixe o mais recente em [nodejs.org](https://nodejs.org/).

### Integração WSL2

Se estiver usando WSL2, acesse os arquivos do Windows:

```bash
# In WSL2
cd /mnt/c/Users/YourName

Acesse arquivos WSL2 do Windows:

# In PowerShell
cd \\wsl$\Ubuntu\home\username

Dicas de desempenho

Desempenho WSL2

Se estiver usando WSL2:

• Armazene dados OpenClaw no sistema de arquivos WSL2 (mais rápido)
• Use WSL2 para todas as operações
• Acesse arquivos do Windows via /mnt/c/ quando necessário

Windows Defender

Exclua os diretórios OpenClaw da verificação em tempo real:

1. Segurança do Windows → Proteção contra vírus e ameaças
2. Gerenciar configurações → Exclusões
3. Adicione pastas:
   • C:\Users\YourName\AppData\Roaming\npm
   • C:\Users\YourName\.openclaw

Gerenciamento de memória

Monitore o uso de recursos:

Get-Process | Where-Object {$_.ProcessName -like "*node*"} | Select-Object ProcessName, CPU, WorkingSet

Atualizando o OpenClaw

Atualize para a versão mais recente:

npm update -g openclaw

Ou execute novamente o instalador:

irm https://openclaw.ai/install.ps1 | iex

Desinstalando

Remover OpenClaw:

npm uninstall -g openclaw

Remover configuração:

Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

Remova do PATH (se adicionado manualmente).

Próximas etapas

Agora que o OpenClaw está instalado no Windows:

1. Conectar aplicativos de bate-papo — WhatsApp, Telegram, Discord
2. Configurar integrações — Gmail, Slack
3. Explorar habilidades — Biblioteca de habilidades
4. Leia as perguntas frequentes — Perguntas comuns

Conclusão

Instalar o OpenClaw no Windows é simples com o npm. Embora o WSL2 ofereça a melhor experiência, a instalação nativa do Windows funciona perfeitamente para a maioria dos usuários. O PowerShell é recomendado em vez do CMD para melhor compatibilidade e recursos de script.

Para obter mais ajuda, consulte nosso guia geral de instalação ou página de perguntas frequentes. Boa automação no Windows!