OpenClaw Manual OpenClaw
6 Étapes pour Déployer

OpenClaw Démarrage

Suivez ces étapes pour installer et configurer OpenClaw depuis zéro

Chemin le Plus Rapide

Vous voulez juste essayer ? Une commande démarre le Dashboard pour chatter instantanément :

$ openclaw dashboard
http://127.0.0.1:18789/

Exigences OpenClaw

Avant de commencer, assurez-vous que votre système répond à ces exigences

Node.js ≥ 22

Requis pour exécuter OpenClaw

Système d'Exploitation

macOS, Linux ou Windows (WSL2 recommandé)

Brave Search API (Optionnel)

Active la fonctionnalité de recherche web

Windows
Les utilisateurs Windows sont fortement encouragés à utiliser WSL2 pour une meilleure compatibilité et performance.
1

Installer OpenClaw

Choisissez votre méthode d'installation préférée. L'installation en une ligne est recommandée

$ curl -fsSL https://openclaw.ai/install.sh | bash
La commande en une ligne détecte et installe automatiquement Node.js et toutes les dépendances. Aucune configuration manuelle requise.
2

Assistant de Configuration OpenClaw

L'assistant vous guidera à travers toute la configuration nécessaire incluant gateway, authentification et connexions des plateformes de chat

$ openclaw onboard --install-daemon

L'assistant configurera

  • Type de Gateway - Choisir gateway local ou distant
  • Authentification Modèle IA - OpenAI (OAuth/Clé API) ou Anthropic (Clé API recommandée, claude setup-token aussi supporté)
  • Plateformes de Chat - Code QR WhatsApp, Token Bot Telegram/Discord, etc.
  • Service Daemon - Installation service en arrière-plan (macOS: launchd, Linux/WSL2: systemd)
Emplacements des Fichiers de Configuration (Important)
  • Répertoire de configuration principal ~/.openclaw/
  • Identifiants OAuth ~/.openclaw/credentials/oauth.json
  • Profils d'authentification (OAuth + Clé API) ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Si vous avez Claude Code installé, vous pouvez réutiliser les identifiants existants via claude setup-token sans reconfiguration.
Conseil serveur headless : Complétez OAuth sur une machine avec navigateur d'abord, puis copiez le fichier oauth.json dans le répertoire correspondant du serveur.
3

Démarrer Gateway OpenClaw

Le gateway est le service central d'OpenClaw qui gère tous les messages

Vérifier le statut du service

$ openclaw gateway status

Démarrer gateway manuellement (pour spécifier le port)

$ openclaw gateway --port 18789

Accéder au Dashboard Web

http://127.0.0.1:18789/
Vérification Rapide (confirmer que le service fonctionne) 
$ openclaw status
$ openclaw health
$ openclaw security audit --deep
4

Connecter les Plateformes de Chat

Appairez et connectez votre première interface de chat

WhatsApp ( Connexion par Code QR ) 

$ openclaw channels login

Exécutez la commande pour afficher un code QR. Ouvrez WhatsApp → Paramètres → Appareils liés → Scannez le code QR pour vous connecter.

Un numéro de téléphone dédié est recommandé. Les numéros VoIP ne sont pas recommandés (facilement bloqués). Les identifiants sont stockés dans le répertoire ~/.openclaw/credentials/whatsapp/.

Telegram / Discord / Autres

L'assistant peut aider à configurer les tokens. Si vous préférez la configuration manuelle, consultez ces documents :

Conseil Telegram : Votre premier DM retournera un code d'appairage. Vous devez l'approuver (voir étape suivante), sinon le bot ne répondra pas.
5

Configuration Sécurité OpenClaw

Assurez-vous que seuls les utilisateurs autorisés peuvent utiliser votre assistant IA

Comportement par défaut : Les DM inconnus reçoivent un code court, et les messages ne seront pas traités tant qu'ils ne sont pas approuvés. Si votre premier DM n'obtient pas de réponse, approuvez l'appairage :

Lister les demandes d'appairage en attente

$ openclaw pairing list whatsapp

Approuver l'appairage (remplacez [code] par le code réel)

$ openclaw pairing approve whatsapp
C'est une mesure de sécurité importante pour prévenir les accès non autorisés. Vous pouvez aussi configurer une liste d'autorisation dans le fichier de configuration pour autoriser automatiquement des numéros spécifiques.
6

Vérifier OpenClaw

Dans un nouveau terminal, envoyez un message test

Envoyer un message test (remplacez par votre numéro cible)

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
Si openclaw health affiche "auth not configured", retournez à l'assistant et configurez l'authentification OAuth/clé API—sans elle, l'agent ne répondra pas.

Conseils de Débogage

  • openclaw status --all Meilleur rapport de débogage copier-coller, lecture seule
  • openclaw health ou openclaw status --deep Demande un instantané de santé du gateway en cours d'exécution

Configuration OpenClaw Terminée

Félicitations ! Vous avez installé et configuré OpenClaw avec succès. Commencez à chatter avec votre assistant IA maintenant.