Ejecuta el asistente de IA Clawdbot en Windows usando WSL2. Experiencia Linux completa con Ubuntu para un entorno de ejecución consistente y compatibilidad de herramientas.

Descripción General de Clawdbot en Windows

Clawdbot en Windows se recomienda vía WSL2 (se recomienda Ubuntu). El CLI + Gateway se ejecutan dentro de Linux, lo que mantiene el entorno de ejecución consistente y hace que las herramientas sean mucho más compatibles.

Windows nativo puede ser más complicado. WSL2 te da la experiencia Linux completa — un comando para instalar: wsl --install.

Las aplicaciones complementarias nativas para Windows están planificadas.

Instalación (WSL2)

Paso 1: Instalar WSL2 + Ubuntu

Abre PowerShell (Admin):

wsl --install
# O elige una distribución explícitamente:
wsl --list --online
wsl --install -d Ubuntu-24.04

Reinicia si Windows lo solicita.

Paso 2: Habilitar systemd (Requerido)

En tu terminal WSL:

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

Luego desde PowerShell:

wsl --shutdown

Vuelve a abrir Ubuntu, luego verifica:

systemctl --user status

Paso 3: Instalar Clawdbot (Dentro de WSL)

Sigue el flujo de Primeros Pasos de Linux dentro de WSL:

# Opción 1: Instalación rápida
curl -fsSL https://clawd.bot/install.sh | bash

# Opción 2: Desde código fuente
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

Instalación del Servicio Gateway (CLI)

Dentro de WSL2:

# Opción 1
clawdbot onboard --install-daemon

# Opción 2
clawdbot gateway install

# Opción 3
clawdbot configure
# Selecciona "Gateway service" cuando se te solicite

Reparar/migrar:

clawdbot doctor

Exponer Servicios WSL a través de LAN (Avanzado)

WSL tiene su propia red virtual. Si otra máquina necesita acceder a un servicio que se ejecuta dentro de WSL, debes reenviar un puerto de Windows a la IP actual de WSL.

Nota: La IP de WSL cambia después de reinicios, por lo que es posible que debas actualizar la regla de reenvío.

Ejemplo (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 a través del Firewall (Una vez)

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

Actualizar Después de Reinicio de 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 desde otra máquina apunta a la IP del host Windows (ej. ssh user@windows-host -p 2222)
Usa listenaddress=0.0.0.0 para acceso LAN; 127.0.0.1 lo mantiene solo local
Para actualización automática, registra una Tarea Programada para ejecutar al iniciar sesión

Configuración del Gateway

Consulta las guías principales:

Verificaciones de Salud

clawdbot status
clawdbot health
clawdbot doctor

Aplicación Complementaria para Windows

Aún no tenemos una aplicación complementaria para Windows. Las contribuciones son bienvenidas.

Próximos Pasos

Clawdbot macOS - Configuración macOS
Clawdbot Linux - Configuración Linux
Clawdbot Gateway - Configuración del Gateway

Configuración de Clawdbot en Windows (WSL2)