Guide d'installation

Installer ZeniClaw sur Windows + WSL

De zero a une plateforme IA fonctionnelle sur votre PC Windows, en 15 minutes.

Sommaire

  1. Pre-requis
  2. Installer WSL
  3. Installer ZeniClaw
  4. Acceder a ZeniClaw
  5. Configuration initiale
  6. Mettre a jour
  7. Depannage

0 Pre-requis

💻
Windows 10/11
Version 2004+ (Build 19041+)
🧠
RAM
8 Go minimum, 16 Go recommande
💾
Disque
10 Go libres minimum
🌐
Internet
Pour le telechargement initial

Virtualisation requise : WSL necessite que la virtualisation soit activee dans le BIOS/UEFI de votre machine. Sur la plupart des PC recents, c'est deja le cas. Si l'installation de WSL echoue, verifiez les parametres Intel VT-x ou AMD-V dans votre BIOS.

1 Installer WSL

WSL (Windows Subsystem for Linux) permet d'executer Linux directement sur Windows, sans machine virtuelle lourde. ZeniClaw tourne dans un environnement Linux via WSL.

1.1 — Ouvrir PowerShell en administrateur

Faites un clic droit sur le menu Demarrer et selectionnez "Terminal (admin)" ou "PowerShell (admin)".

1.2 — Installer WSL et Ubuntu

PowerShell (Admin) 
wsl --install

Cette commande installe automatiquement WSL 2 avec Ubuntu. Votre PC redemarrera peut-etre.

Premiere fois ? Apres le redemarrage, Ubuntu se lancera et vous demandera de creer un nom d'utilisateur et un mot de passe. Ce sont vos identifiants Linux, pas ceux de Windows.

1.3 — Verifier l'installation

Ouvrez un terminal Ubuntu (cherchez "Ubuntu" dans le menu Demarrer) et tapez :

Ubuntu (WSL) 
$ wsl --version
WSL version: 2.x.x.x
Kernel version: 5.15.x.x
...

1.4 — Mettre a jour les paquets

Ubuntu (WSL) 
$ sudo apt update && sudo apt upgrade -y

2 Installer ZeniClaw

L'installation de ZeniClaw se fait en une seule commande. Le script installe automatiquement Podman (moteur de conteneurs), configure tout et demarre les services.

2.1 — Lancer l'installateur

Ubuntu (WSL) 
$ bash <(curl -fsSL https://raw.githubusercontent.com/zeniclaw/core/main/install.sh)

Le script va automatiquement :

  1. Installer Podman, Git et les dependances necessaires
  2. Vous demander la configuration (port, cles API, proxy, etc.)
  3. Telecharger et construire les conteneurs (app, base de donnees, cache, etc.)
  4. Initialiser la base de donnees et creer les tables
  5. Demarrer tous les services

2.2 — Configuration interactive

Le script vous posera quelques questions :

Port HTTP — Port d'acces web (defaut : 8080). Gardez le defaut sauf si ce port est deja utilise.

Cles API LLM — Optionnel. Vous pouvez ajouter votre cle API Anthropic (Claude), OpenAI, ou autre. Vous pourrez aussi les configurer plus tard depuis l'interface.

Ollama (LLM local) — Si vous voulez utiliser des modeles IA en local (sans API externe), activez Ollama. Necessite ~8 Go de RAM supplementaires.

2.3 — Attendre la fin de l'installation

La premiere installation prend 5 a 15 minutes selon votre connexion. Le script affiche la progression en temps reel :

Sortie d'installation
-- 1/6 -- Pre-flight Checks --
  Podman ................ OK
  Git ................... OK
  Ports ................. OK

-- 4/6 -- Building & Starting Services --
  [1/3] Pulling db (postgres:16-alpine) ... OK
  [2/3] Pulling redis (redis:7-alpine) .... OK
  Building container images ............... OK
  Starting services ....................... OK

-- 6/6 -- Installation Complete! --
  ZeniClaw is running at http://localhost:8080

3 Acceder a ZeniClaw

Une fois l'installation terminee, ouvrez votre navigateur Windows et allez sur :

Navigateur Windows
http://localhost:8080

Vous arriverez sur la page de connexion. Creez votre compte administrateur en cliquant sur "Create Account".

C'est tout ! ZeniClaw est pret. Le premier compte cree aura automatiquement les droits super-administrateur.

Acces depuis d'autres appareils (reseau local)

Pour acceder a ZeniClaw depuis un autre PC ou votre telephone sur le meme reseau :

  1. Trouvez l'IP de votre PC Windows : ipconfig dans PowerShell
  2. Accedez a http://VOTRE_IP:8080 depuis l'autre appareil

4 Configuration initiale

Ajouter une cle API

Pour utiliser les agents IA, vous avez besoin d'au moins une cle API LLM :

  1. Allez dans Settings (icone engrenage)
  2. Section "LLM API Keys"
  3. Ajoutez votre cle Anthropic (Claude) ou OpenAI

Utiliser Ollama (IA locale, sans API)

Si vous avez active Ollama a l'installation, telechargez un modele :

Ubuntu (WSL) 
$ podman exec zeniclaw_ollama ollama pull llama3.2
# Ou un modele plus leger :
$ podman exec zeniclaw_ollama ollama pull phi3:mini

Le modele sera disponible automatiquement dans l'interface ZeniClaw.

5 Mettre a jour

Depuis l'interface web

Allez dans Admin > Update et cliquez sur "Update". Le code sera mis a jour automatiquement.

Depuis le terminal

Ubuntu (WSL) 
$ cd ~/zeniclaw
$ git pull origin main
$ podman compose up -d --build --force-recreate app

6 Depannage

"wsl --install" ne fait rien

Votre version de Windows est peut-etre trop ancienne. Mettez a jour Windows via Parametres > Windows Update, puis reessayez.

"systemctl" ne fonctionne pas dans WSL

Systemd doit etre active. Executez :

Ubuntu (WSL) 
$ echo -e "[boot]\nsystemd=true" | sudo tee /etc/wsl.conf
# Puis dans PowerShell (pas Ubuntu) :
PS> wsl --shutdown
# Reouvrez Ubuntu

Le port 8080 est deja utilise

Modifiez le port dans le fichier .env :

Ubuntu (WSL) 
$ cd ~/zeniclaw
$ nano .env
# Changez APP_PORT=8080 en APP_PORT=9090 (ou autre)
$ podman compose down && podman compose up -d

Les conteneurs ne demarrent pas

Ubuntu (WSL) 
# Verifier l'etat des conteneurs :
$ podman ps -a

# Voir les logs d'un conteneur :
$ podman logs zeniclaw_app

# Tout relancer :
$ cd ~/zeniclaw && podman compose down && podman compose up -d

Relancer ZeniClaw apres un redemarrage Windows

WSL demarre automatiquement, mais les conteneurs doivent etre relances :

Ubuntu (WSL) 
$ cd ~/zeniclaw && podman compose up -d

Demarrage automatique : Pour lancer ZeniClaw automatiquement au demarrage de Windows, ajoutez cette ligne a votre ~/.bashrc :
cd ~/zeniclaw && podman compose up -d 2>/dev/null

Desinstaller ZeniClaw

Ubuntu (WSL) 
$ cd ~/zeniclaw && podman compose down -v
$ cd ~ && rm -rf zeniclaw