Execute o assistente de IA Clawdbot no Windows usando WSL2. Experiência Linux completa com Ubuntu para ambiente de execução consistente e compatibilidade de ferramentas.

Visão Geral do Clawdbot no Windows

O Clawdbot no Windows é recomendado via WSL2 (Ubuntu recomendado). O CLI + Gateway rodam dentro do Linux, o que mantém o ambiente de execução consistente e torna as ferramentas muito mais compatíveis.

O Windows nativo pode ser mais complicado. O WSL2 oferece a experiência Linux completa — um comando para instalar: wsl --install.

Aplicativos complementares nativos para Windows estão planejados.

Instalação (WSL2)

Passo 1: Instalar WSL2 + Ubuntu

Abra o PowerShell (Admin):

wsl --install
# Ou escolha uma distribuição explicitamente:
wsl --list --online
wsl --install -d Ubuntu-24.04

Reinicie se o Windows solicitar.

Passo 2: Habilitar systemd (Necessário)

No seu terminal WSL:

sudo tee /etc/wsl.conf > /dev/null << 'EOF'
[boot]
systemd=true
EOF

Depois, no PowerShell:

wsl --shutdown

Reabra o Ubuntu e verifique:

systemctl --user status

Passo 3: Instalar o Clawdbot (Dentro do WSL)

Siga o fluxo de Primeiros Passos do Linux dentro do WSL:

# Opção 1: Instalação rápida
curl -fsSL https://clawd.bot/install.sh | bash

# Opção 2: Do código-fonte
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

Instalação do Serviço Gateway (CLI)

Dentro do WSL2:

# Opção 1
clawdbot onboard --install-daemon

# Opção 2
clawdbot gateway install

# Opção 3
clawdbot configure
# Selecione "Gateway service" quando solicitado

Reparar/migrar:

clawdbot doctor

Expor Serviços WSL na LAN (Avançado)

O WSL tem sua própria rede virtual. Se outra máquina precisar acessar um serviço rodando dentro do WSL, você deve encaminhar uma porta do Windows para o IP atual do WSL.

Nota: O IP do WSL muda após reinicializações, então você pode precisar 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

Permitir no Firewall (Uma vez)

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
    -Protocol TCP -LocalPort $ListenPort -Action Allow

Atualizar Após Reinício 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

Notas:

SSH de outra máquina aponta para o IP do host Windows (ex.: ssh user@windows-host -p 2222)
Use listenaddress=0.0.0.0 para acesso LAN; 127.0.0.1 mantém apenas local
Para atualização automática, registre uma Tarefa Agendada para executar no login

Configuração do Gateway

Veja os guias principais:

Verificações de Saúde

clawdbot status
clawdbot health
clawdbot doctor

Aplicativo Complementar para Windows

Ainda não temos um aplicativo complementar para Windows. Contribuições são bem-vindas.

Próximos Passos

Clawdbot macOS - Configuração macOS
Clawdbot Linux - Configuração Linux
Clawdbot Gateway - Configuração do Gateway

Configuração do Clawdbot no Windows (WSL2)