Tutoriel 01 — Démarrage rapide : lancez votre assistant IA privé en 5 minutes

Objectif : installer OpenClaw, configurer le modèle MiniMax, démarrer la passerelle et envoyer votre premier message.

Ce dont vous avez besoin

macOS / Linux (Windows nécessite WSL2)
Node.js 22+ (recommandé avec nvm)
pnpm 9+
Une clé API MiniMax (inscription)

Étape 1 : Cloner et installer les dépendances

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install

Étape 2 : Configurer les variables d'environnement

Copiez le fichier .env d'exemple et renseignez votre clé API MiniMax :

cp .env.example .env   # Si le fichier example n'existe pas, créez directement ~/.openclaw/.env

Éditez .env et ajoutez :

MINIMAX_API_KEY=sk-votre-clé

Étape 3 : Créer le fichier de configuration

Créez ~/.openclaw/openclaw.json :

{
  "gateway": { "mode": "local" },
  "env": { "MINIMAX_API_KEY": "${MINIMAX_API_KEY}" },
  "agents": {
    "defaults": {
      "model": { "primary": "minimax/MiniMax-M2.1" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "apiKey": "${MINIMAX_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 15, "output": 60, "cacheRead": 2, "cacheWrite": 10 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Étape 4 : Installer et démarrer la passerelle

pnpm openclaw gateway install
pnpm openclaw gateway start

Vérifiez le statut :

pnpm openclaw gateway status
# Vous devriez voir Runtime: running et RPC probe: ok

Étape 5 : Ouvrir le WebChat

Accédez dans votre navigateur à :

http://127.0.0.1:18789/

Envoyez votre premier message, par exemple :

« Bonjour ! Peux-tu m'écrire un tri à bulles en Python ? »

Vérifier le modèle

pnpm openclaw models list
# Vous devriez voir minimax/MiniMax-M2.1  default

Questions fréquentes

OpenClaw est-il compatible avec Windows ?

OpenClaw prend en charge macOS et Linux. Les utilisateurs Windows doivent installer WSL2 (Windows Subsystem for Linux), puis suivre les mêmes étapes dans l'environnement WSL2. Consultez la documentation officielle de Microsoft pour installer WSL2.

Quels modèles d'IA OpenClaw supporte-t-il en plus de MiniMax ?

OpenClaw prend en charge plusieurs fournisseurs de modèles populaires, notamment MiniMax (M2.1, M2.5, VL-01), Anthropic (Claude Sonnet, Opus), OpenAI (GPT-4o), etc. Consultez le tutoriel 05 pour la configuration multi-modèles.

Que faire si le navigateur ne s'ouvre pas après le démarrage de la passerelle ?

Vérifiez d'abord que le port n'est pas occupé : lsof -i :18789. En cas de conflit de port, modifiez le champ gateway.port dans openclaw.json puis redémarrez. Si le problème vient du pare-feu, assurez-vous que l'accès localhost n'est pas bloqué.

Comment résoudre les erreurs de `pnpm install` ?

La cause la plus fréquente est une version de Node.js insuffisante (22+ requise). Vérifiez avec node -v et utilisez nvm pour installer la bonne version : nvm install 22 && nvm use 22, puis relancez pnpm install.

Que faire si l'IA ne répond pas après l'envoi d'un message ?

Lancez pnpm openclaw gateway status pour vérifier que la passerelle fonctionne (vous devriez voir Runtime: running). Ensuite, pnpm openclaw models list pour confirmer que le modèle est bien chargé. Si la liste est vide, vérifiez la configuration de votre clé API.

Prochaines étapes

Tutoriel 02 — Connecter l'IA à Telegram pour l'interroger depuis votre téléphone
Tutoriel 03 — Écrire votre propre Skill pour donner de nouvelles capacités à l'IA