OpenClaw
GitHubCommencer
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 <code>
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 --allMeilleur rapport de débogage copier-coller, lecture seule
  • openclaw healthouopenclaw status --deepDemande 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.