Exécutez l'assistant IA Clawdbot sur Windows en utilisant WSL2. Expérience Linux complète avec Ubuntu pour un environnement d'exécution cohérent et une compatibilité des outils.

Aperçu de Clawdbot sur Windows

Clawdbot sur Windows est recommandé via WSL2 (Ubuntu recommandé). Le CLI + Gateway fonctionnent à l'intérieur de Linux, ce qui maintient l'environnement d'exécution cohérent et rend les outils bien plus compatibles.

Windows natif peut être plus délicat. WSL2 vous donne l'expérience Linux complète — une seule commande pour installer : wsl --install.

Des applications compagnon natives pour Windows sont prévues.

Installation (WSL2)

Étape 1 : Installer WSL2 + Ubuntu

Ouvrez PowerShell (Admin) :

wsl --install
# Ou choisissez explicitement une distribution :
wsl --list --online
wsl --install -d Ubuntu-24.04

Redémarrez si Windows le demande.

Étape 2 : Activer systemd (Requis)

Dans votre terminal WSL :

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

Puis depuis PowerShell :

wsl --shutdown

Rouvrez Ubuntu, puis vérifiez :

systemctl --user status

Étape 3 : Installer Clawdbot (Dans WSL)

Suivez le flux de Démarrage Linux dans WSL :

# Option 1 : Installation rapide
curl -fsSL https://clawd.bot/install.sh | bash

# Option 2 : Depuis les sources
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

Installation du Service Gateway (CLI)

Dans WSL2 :

# Option 1
clawdbot onboard --install-daemon

# Option 2
clawdbot gateway install

# Option 3
clawdbot configure
# Sélectionnez "Gateway service" lorsque demandé

Réparation/migration :

clawdbot doctor

Exposer les Services WSL sur le LAN (Avancé)

WSL a son propre réseau virtuel. Si une autre machine a besoin d'accéder à un service fonctionnant dans WSL, vous devez transférer un port Windows vers l'IP WSL actuelle.

Note : L'IP WSL change après les redémarrages, vous devrez peut-être actualiser la règle de transfert.

Exemple (PowerShell en tant qu'Administrateur)

$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

Autoriser dans le Pare-feu (Une fois)

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

Actualiser Après Redémarrage 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

Notes :

SSH depuis une autre machine cible l'IP de l'hôte Windows (ex. ssh user@windows-host -p 2222)
Utilisez listenaddress=0.0.0.0 pour l'accès LAN ; 127.0.0.1 le garde local uniquement
Pour l'actualisation automatique, enregistrez une Tâche Planifiée à exécuter à la connexion

Configuration du Gateway

Consultez les guides principaux :

Vérifications de Santé

clawdbot status
clawdbot health
clawdbot doctor

Application Compagnon Windows

Nous n'avons pas encore d'application compagnon Windows. Les contributions sont les bienvenues.

Prochaines Étapes

Clawdbot macOS - Configuration macOS
Clawdbot Linux - Configuration Linux
Clawdbot Gateway - Configuration du Gateway

Configuration de Clawdbot sur Windows (WSL2)