Pular para o conteúdo principal

​
Windows

O OpenClaw oferece suporte tanto a Windows nativo quanto a WSL2. O WSL2 é o caminho mais estável e recomendado para a experiência completa — a CLI, o Gateway e as ferramentas são executados dentro do Linux com compatibilidade total. O Windows nativo funciona para o uso principal da CLI e do Gateway, com algumas limitações observadas abaixo. Apps complementares nativos para Windows estão planejados.

​
WSL2 (recomendado)

​
Status do Windows nativo

Os fluxos da CLI no Windows nativo estão melhorando, mas o WSL2 ainda é o caminho recomendado. O que funciona bem no Windows nativo hoje:
  • instalador do site via install.ps1
  • uso local da CLI, como openclaw --version, openclaw doctor e openclaw plugins list --json
  • smoke de agent/provider local incorporado, como:
openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."
Limitações atuais:
  • openclaw onboard --non-interactive ainda espera um gateway local acessível, a menos que você passe --skip-health
  • openclaw onboard --non-interactive --install-daemon e openclaw gateway install tentam primeiro usar Tarefas Agendadas do Windows
  • se a criação da Tarefa Agendada for negada, o OpenClaw recorre a um item de login por usuário na pasta Startup e inicia o gateway imediatamente
  • se o próprio schtasks travar ou parar de responder, o OpenClaw agora aborta esse caminho rapidamente e recorre ao fallback em vez de ficar travado para sempre
  • as Tarefas Agendadas ainda são preferidas quando disponíveis porque oferecem melhor status de supervisor
Se você quiser apenas a CLI nativa, sem instalar o serviço do gateway, use um destes: 
openclaw onboard --non-interactive --skip-health
openclaw gateway run
Se você quiser inicialização gerenciada no Windows nativo: 
openclaw gateway install
openclaw gateway status --json
Se a criação da Tarefa Agendada estiver bloqueada, o modo de serviço de fallback ainda inicia automaticamente após o login por meio da pasta Startup do usuário atual.

​
Gateway

​
Instalação do serviço Gateway (CLI)

Dentro do WSL2: 
openclaw onboard --install-daemon
Ou: 
openclaw gateway install
Ou: 
openclaw configure
Selecione Serviço do Gateway quando solicitado. Reparar/migrar: 
openclaw doctor

​
Inicialização automática do Gateway antes do login no Windows

Para configurações headless, garanta que toda a cadeia de inicialização seja executada mesmo quando ninguém fizer login no Windows.

​
1) Mantenha os serviços do usuário em execução sem login

Dentro do WSL: 
sudo loginctl enable-linger "$(whoami)"

​
2) Instale o serviço de usuário do gateway OpenClaw

Dentro do WSL: 
openclaw gateway install

​
3) Inicie o WSL automaticamente na inicialização do Windows

No PowerShell como Administrador: 
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
Substitua Ubuntu pelo nome da sua distro em: 
wsl --list --verbose

​
Verificar a cadeia de inicialização

Após uma reinicialização (antes do login no Windows), verifique no WSL: 
systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

​
Avançado: expor serviços do WSL pela LAN (portproxy)

O WSL tem sua própria rede virtual. Se outra máquina precisar acessar um serviço em execução dentro do WSL (SSH, um servidor TTS local ou o Gateway), você precisará encaminhar uma porta do Windows para o IP atual do WSL. O IP do WSL muda após reinicializações, então talvez seja necessário atualizar a regra de encaminhamento. Exemplo (PowerShell como Administrador): 
$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL IP not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort
Permita a porta no Firewall do Windows (uma única vez): 
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
Atualize o portproxy após reinicializações do WSL: 
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null
Observações:
  • O SSH a partir de outra máquina deve apontar para o IP do host Windows (exemplo: ssh user@windows-host -p 2222).
  • Nós remotos precisam apontar para uma URL do Gateway acessível (não 127.0.0.1); use openclaw status --all para confirmar.
  • Use listenaddress=0.0.0.0 para acesso pela LAN; 127.0.0.1 mantém o acesso apenas local.
  • Se quiser isso automático, registre uma Tarefa Agendada para executar a etapa de atualização no login.

​
Instalação passo a passo do WSL2

​
1) Instale o WSL2 + Ubuntu

Abra o PowerShell (Admin): 
wsl --install
# Ou escolha uma distro explicitamente:
wsl --list --online
wsl --install -d Ubuntu-24.04
Reinicie se o Windows solicitar.

​
2) Ative o systemd (necessário para instalar o gateway)

No seu terminal WSL: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Depois, no PowerShell: 
wsl --shutdown
Abra o Ubuntu novamente e então verifique: 
systemctl --user status

​
3) Instale o OpenClaw (dentro do WSL)

Siga o fluxo Linux de Primeiros passos dentro do WSL: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # instala automaticamente as dependências da UI na primeira execução
pnpm build
openclaw onboard
Guia completo: Primeiros passos

​
App complementar para Windows

Ainda não temos um app complementar para Windows. Contribuições são bem-vindas se você quiser ajudar a tornar isso realidade.