Le guide complet d'OpenClaw : de la premiere installation a l'utilisateur avance

Qu'est-ce qu'OpenClaw, et pourquoi devriez-vous vous y interesser ?

OpenClaw est un agent IA open-source qui fonctionne sur votre propre machine -- votre ordinateur portable, un serveur domestique ou un VPS cloud. Contrairement aux outils IA bases sur le navigateur qui se contentent de repondre a des questions, OpenClaw passe a l'action : il lit vos e-mails, planifie des reunions, organise des fichiers, envoie des messages via WhatsApp, Telegram et Discord, et automatise les taches repetitives -- le tout en langage naturel.

Depuis son lancement en janvier 2026, le projet a depasse les 244 000 etoiles sur GitHub, ce qui en fait l'un des depots open-source a la croissance la plus rapide de tous les temps. La raison est simple : les gens veulent un assistant IA qui fait vraiment les choses, pas un qui se contente d'en parler.

Voici un moyen rapide de comprendre la difference :

Chatbot IA traditionnel :

Vous : "Aide-moi a organiser les fichiers de mon bureau." IA : "Bien sur ! Voici quelques conseils : 1. Creez des dossiers par type... 2. Deplacez les fichiers en consequence..."

OpenClaw :

Vous : "Aide-moi a organiser les fichiers de mon bureau." OpenClaw : renomme, trie et deplace 47 fichiers dans 5 dossiers -- "Termine ! J'ai tout organise par type de fichier."

C'est le changement fondamental : d'un chatbot a un agent.

Ce guide vous accompagne tout au long du parcours -- de votre premiere installation a la creation de Skills personnalises et a la gestion de plusieurs agents. Que vous disposiez de 30 minutes ou d'un apres-midi entier, avancez a votre rythme dans chaque section.

Premiers pas : installation et configuration

Ce dont vous avez besoin

• Node.js 22+ (LTS recommande) -- verifiez avec node --version
• Une cle API de modele IA -- Anthropic Claude (recommande), OpenAI, ou un modele local via Ollama
• macOS, Linux ou Windows avec WSL2

Installer OpenClaw

Le chemin le plus rapide est l'installateur en une seule ligne :

curl -fsSL https://openclaw.ai/install.sh | bash

Celui-ci detecte votre systeme, installe les dependances si necessaire et lance l'assistant de configuration. Si vous preferez npm :

npm install -g openclaw@latest

Pour les utilisateurs Docker :

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

Pour une presentation detaillee de chaque methode, consultez notre guide de demarrage rapide.

Lancer l'assistant d'integration

Apres l'installation, l'assistant vous guide a travers tout :

openclaw onboard

Vous allez configurer trois elements :

1. Fournisseur IA et API Key -- Anthropic Claude fonctionne le mieux. Si vous n'avez pas encore de cle, obtenez-en une sur anthropic.com. Soucieux de votre budget ? Consultez notre guide de selection de modele et de couts.
2. Canal de messagerie -- Choisissez-en au moins un : Telegram est le plus facile pour commencer (configuration en 5 minutes). Nous avons des guides dedies pour Telegram, WhatsApp et Discord.
3. Mode de securite -- Choisissez Sandbox pour le moment. Vous pourrez passer a l'acces complet plus tard, une fois que vous serez a l'aise.

Verifier que tout fonctionne

openclaw status

Vous devriez voir :

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

Ouvrez maintenant l'application de messagerie choisie et envoyez votre premier message. Essayez quelque chose de simple :

• "Que peux-tu faire ?"
• "Quelle heure est-il ?"
• "Resume les dernieres actualites tech."

Si votre bot repond, felicitations -- vous avez un agent IA fonctionnel.

Concepts fondamentaux : comment fonctionne OpenClaw

Avant d'aller plus loin, il est utile de comprendre les quatre composants de base d'OpenClaw. Pensez-y de cette maniere :

Gateway -- La porte d'entree

Le Gateway est la facon dont OpenClaw se connecte au monde exterieur. Il gere les messages provenant de Telegram, Discord, WhatsApp, d'une API web ou meme de la ligne de commande. Vous pouvez executer plusieurs gateways simultanement -- par exemple, Telegram pour un usage personnel et Slack pour le travail.

Skills -- La boite a outils

Les Skills sont ce qu'OpenClaw sait faire. Chaque Skill est une capacite packagisee : envoyer des e-mails, rechercher sur le web, gerer des fichiers, controler votre navigateur. Pensez-y comme des applications sur un smartphone. OpenClaw est livre avec quelques Skills integres, mais la vraie puissance vient de l'ecosysteme communautaire sur Clawhub et de la creation de vos propres Skills.

Parcourez notre repertoire de Skills pour decouvrir ce qui est disponible.

Memory -- Le cerveau

OpenClaw se souvient des choses d'une conversation a l'autre. Dites-lui votre nom, votre emploi du temps, vos preferences -- et il retient ce contexte. Contrairement aux chatbots sans etat, OpenClaw construit une comprehension persistante de qui vous etes et de comment vous travaillez, stockee localement dans ~/.openclaw/memory/.

Sandbox -- Le filet de securite

Le Sandbox controle ce qu'OpenClaw est autorise a faire sur votre systeme. En mode sandbox, il ne peut pas acceder a des fichiers arbitraires ni executer des commandes destructrices. C'est votre couche de securite -- particulierement importante lorsque vous experimentez de nouveaux Skills ou que vous donnez a OpenClaw des permissions plus larges.

Pour une configuration de securite detaillee, consultez notre modele de configuration securisee.

Installer et utiliser des Skills

Les Skills sont ce qui fait passer OpenClaw de "demo interessante" a "outil du quotidien." Voici comment commencer.

Parcourir et installer

# Rechercher des Skills par mot-cle
openclaw skills search email

# Voir les details d'un Skill specifique
openclaw skills info @openclaw/email-manager

# L'installer
openclaw skills install @openclaw/email-manager

Cinq Skills a installer en priorite

| Skill | Ce qu'il fait | Commande d'installation | |-------|--------------|------------------------| | Email Manager | Lire, rediger et envoyer des e-mails | openclaw skills install @openclaw/email-manager | | Calendar | Creer des evenements, verifier l'agenda, envoyer des invitations | openclaw skills install @openclaw/calendar | | File Organizer | Trier, renommer et nettoyer des fichiers | openclaw skills install @openclaw/file-organizer | | Web Search | Rechercher sur le web et resumer les resultats | openclaw skills install @openclaw/tavily-search | | Browser Control | Automatiser les taches du navigateur | openclaw plugins install @openclaw/browser-control |

Apres l'installation, parlez simplement a votre agent naturellement :

• "Verifie mes e-mails non lus et resume les 3 principaux."
• "Qu'est-ce qu'il y a dans mon agenda demain ?"
• "Recherche les dernieres notes de version d'OpenClaw."

Gerer vos Skills

# Lister tous les Skills installes
openclaw skills list

# Mettre a jour tous les Skills
openclaw skills update

# Supprimer un Skill dont vous n'avez plus besoin
openclaw skills remove @openclaw/file-organizer

Avant d'installer des Skills tiers, consultez notre checklist de securite des Skills pour rester en securite.

Mettre en place des automatisations (taches cron)

L'une des fonctionnalites les plus pratiques d'OpenClaw est la planification d'automatisations. Au lieu de demander a votre agent de faire quelque chose chaque matin, vous pouvez le configurer une fois et le laisser tourner.

Creer un briefing quotidien

Dites simplement a votre agent en langage naturel :

"Chaque matin a 8h, envoie-moi un briefing avec la meteo du jour, mes evenements d'agenda et le nombre d'e-mails non lus."

OpenClaw creera automatiquement une tache cron. Vous pouvez aussi les gerer manuellement :

# Lister toutes les taches planifiees
openclaw cron list

# Voir les details d'une tache specifique
openclaw cron show <task-id>

# Mettre en pause une tache
openclaw cron disable <task-id>

# La reprendre
openclaw cron enable <task-id>

# La supprimer definitivement
openclaw cron delete <task-id>

Idees d'automatisation

• Briefing quotidien -- Meteo + agenda + e-mails non lus chaque matin
• Resume hebdomadaire -- Rapport le vendredi apres-midi de l'activite de votre semaine
• Suivi de prix -- Surveiller une page produit et vous alerter quand le prix baisse
• Rappel de fin de journee -- Un petit rappel a 18h pour terminer votre travail
• Nettoyage de la boite de reception -- Archiver automatiquement les e-mails de faible priorite chaque soir

Configurer la memoire persistante

Le systeme de memoire d'OpenClaw est ce qui le rend personnel. Plus vous lui donnez de contexte, mieux il vous sert.

Apprenez a votre agent a vous connaitre

Envoyez un message comme celui-ci :

"Retiens ceci a mon sujet : je m'appelle Alex. Je suis chef de produit. Je travaille du lundi au vendredi, de 9h a 18h, fuseau horaire GMT+8. Je prefere les reponses concises. Je communique en anglais mais je peux lire le chinois."

OpenClaw stocke ces informations dans sa memoire a long terme et les applique a chaque interaction future.

Voir et modifier la memoire

# Voir ce que votre agent retient
cat ~/.openclaw/memory/long-term.json

# Ou demandez directement dans le chat
"Que sais-tu de moi ?"

Vous pouvez aussi corriger ou supprimer des souvenirs :

"Oublie mon ancien emploi du temps. Je travaille maintenant de 10h a 19h."

Comment fonctionne la memoire

OpenClaw utilise trois couches de memoire :

• Court terme -- Contexte de la conversation en cours (efface apres chaque session)
• Long terme -- Faits persistants vous concernant (preferences, habitudes, informations biographiques)
• Episodique -- Journaux des interactions passees (utilises pour la reconnaissance de tendances au fil du temps)

Cette approche en couches signifie que votre agent devient plus utile a mesure que vous l'utilisez, sans avoir besoin de rappels constants.

Ecrire votre premier Skill personnalise

Lorsque les Skills integres et communautaires ne couvrent pas votre besoin specifique, vous pouvez ecrire le votre. Les Skills OpenClaw utilisent un format YAML simple.

Structure d'un Skill

Creez un nouveau fichier a l'emplacement ~/.openclaw/skills/daily-news.yaml :

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

Le tester

# Recharger les Skills pour prendre en compte le nouveau fichier
openclaw skills reload

# Le tester
openclaw skills test "Daily Tech News"

Puis essayez-le en conversation : "Donne-moi les actualites tech du jour."

Construire des Skills plus complexes

Les Skills peuvent enchainer plusieurs actions :

• web_search -- Rechercher sur le web
• summarize -- Condenser du texte en puces ou paragraphes
• respond -- Envoyer une reponse formatee
• file_read / file_write -- Lire ou creer des fichiers
• shell_exec -- Executer des commandes shell (necessite les permissions appropriees)
• http_request -- Appeler des API externes

Vous pouvez combiner tout cela pour construire des workflows comme : rechercher les prix des vols -> comparer les resultats -> ecrire un resume dans un fichier -> vous notifier sur Telegram.

Gestion multi-agents

A mesure que votre utilisation evolue, vous pouvez vouloir des agents separes pour differents aspects de votre vie -- un pour le travail, un pour les taches personnelles, un pour les experiences.

Creer des agents

# Creer un agent professionnel avec Claude Sonnet
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4-6"

# Creer un agent personnel
openclaw create-agent personal
openclaw config --agent personal set ai.model "claude-haiku-4-5"

# Lister tous les agents
openclaw list-agents

# Basculer entre eux
openclaw switch-agent work

Pourquoi utiliser plusieurs agents ?

| Agent | Modele | Connecte a | Objectif | |-------|--------|-----------|----------| | Work | Claude Sonnet | Slack, Gmail, Linear | Taches professionnelles, tri des e-mails | | Personal | Claude Haiku | Telegram, Google Calendar | Planification, rappels, courses personnelles | | Lab | Ollama (local) | CLI uniquement | Test de nouveaux Skills, experiences |

Chaque agent possede sa propre memoire, ses propres Skills et ses propres connexions de canaux -- completement isoles les uns des autres.

Automatisation du navigateur

OpenClaw peut controler un navigateur pour effectuer des taches qui vont au-dela de simples appels API : remplir des formulaires, extraire des donnees de pages web, comparer des prix sur differents sites ou prendre des captures d'ecran.

Activer le controle du navigateur

# Installer le plugin navigateur
openclaw plugins install @openclaw/browser-control

# L'activer
openclaw config set browser.enabled true

# Afficher la fenetre du navigateur (definir a true pour le debogage)
openclaw config set browser.headless false

Cas d'utilisation

• "Ouvre GitHub et trouve les depots les plus tendance aujourd'hui."
• "Va sur Amazon, recherche des claviers mecaniques et liste les 3 meilleurs par note avec les prix."
• "Remplis le formulaire de contact sur example.com avec mes informations."
• "Prends une capture d'ecran de mon site portfolio."

L'automatisation du navigateur est puissante mais gourmande en ressources. Utilisez-la pour les taches qui necessitent reellement une interaction visuelle avec les pages web -- pour la simple recuperation de donnees, un Skill de recherche web est plus rapide et moins couteux.

Integrations au-dela du chat

OpenClaw se connecte a bien plus que de simples applications de messagerie. Voici quelques integrations populaires :

Google Workspace

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

Une fois connecte, vous pouvez gerer Gmail, Google Calendar et Google Drive en langage naturel.

Gestion de projet (Linear, Jira)

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"Cree une tache haute priorite dans Linear : corriger le bug de redirection de la page de connexion."

Prise de notes (Obsidian, Notion)

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"Cree une nouvelle note dans Obsidian intitulee 'Notes de reunion -- 2 mars' avec les points de discussion d'aujourd'hui."

Pour une liste complete des plateformes prises en charge, consultez notre repertoire d'integrations de canaux.

Securite et controle des couts

Docker Sandbox

Pour une isolation maximale, executez OpenClaw dans un Docker Sandbox :

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

Cela restreint l'acces au systeme de fichiers, l'acces au reseau et l'execution de commandes shell a des limites predefinies.

Executer un audit de securite

openclaw security audit --deep

Cela verifie les permissions mal configurees, les tokens exposes et d'autres problemes courants.

Pour un guide complet de renforcement de la securite, lisez Exposition des ports et acces a distance.

Controler vos depenses

Les couts d'API peuvent s'accumuler. Voici comment mettre en place des garde-fous :

# Definir une limite quotidienne de requetes
openclaw config set ai.dailyLimit 1000

# Definir un plafond de budget mensuel (en USD)
openclaw config set ai.monthlyBudget 50

# Verifier votre utilisation
openclaw stats usage
openclaw stats cost

Couts mensuels typiques :

| Niveau d'utilisation | Description | Cout estime | |---------------------|-------------|-------------| | Leger | 10-20 conversations/jour | 5-10 $/mois | | Modere | 50-100 conversations + taches cron | 20-30 $/mois | | Intensif | Automatisations + controle du navigateur | 50-100 $/mois |

Vous souhaitez approfondir l'optimisation des couts ? Consultez notre guide de selection de modele et de couts.

Reference rapide de depannage

| Symptome | Cause probable | Solution | |----------|---------------|----------| | EADDRINUSE au demarrage | Port 18789 deja utilise | openclaw gateway start --port 18790 | | 401 Unauthorized | API Key invalide ou expiree | openclaw config set api-key | | Le bot ne repond pas | Canal non connecte | Verifiez openclaw status et la configuration du canal | | Reponses lentes | Modele surcharge ou problemes de reseau | Essayez un modele plus leger ou verifiez la connexion | | Les Skills ne se chargent pas | Rechargement necessaire apres installation | openclaw skills reload |

Pour un depannage plus detaille, consultez notre guide des erreurs courantes.

Commandes de diagnostic utiles

# Verification complete de l'etat de sante
openclaw doctor

# Voir les journaux
openclaw logs

# Mode debogage
openclaw config set logging.level "debug"

Et ensuite ?

Vous avez couvert beaucoup de terrain. Voici ou aller selon vos interets :

• Vous voulez plus de canaux ? Explorez nos guides d'integration de plus de 50 canaux -- de Slack et Teams a WeChat et Line.
• La securite vous interesse ? Lisez la checklist de securite des Skills et le guide de configuration securisee.
• Vous voulez heberger vous-meme ? Consultez notre guide sur l'acces a distance et l'exposition des ports.
• Pret a contribuer ? Le depot GitHub OpenClaw accueille les pull requests, les contributions de Skills et les rapports de bugs.

OpenClaw represente un veritable changement dans notre facon d'interagir avec l'IA -- passer de la demande de conseils a la delegation de taches reelles. Le projet avance vite, la communaute grandit, et le meilleur moment pour commencer a construire votre propre configuration d'agent IA, c'est maintenant.