Changer le thème

Manuel pratique complet OpenClaw : du débutant à l'expert

Easton editorial illustration: supervisor dispatch desk

Un client écrit : rapport concurrentiel demain 9 h. Une dizaine d’onglets ouverts, 200+ e-mails non lus. J’ouvre OpenClaw et tape : « Rassemble les actus de la semaine sur le concurrent A et génère un rapport. » Cinq minutes plus tard, le rapport arrive sur Telegram.

Troisième mois avec OpenClaw. Au début, je ne voyais pas la différence avec ChatGPT — « discuter avec une IA », non ? En réalité, ce n’est pas la même chose. OpenClaw est un framework d’agent IA open source : vous donnez un objectif, il planifie, appelle des outils, exécute et vous rend le résultat. Pas besoin de le pousser à chaque étape comme avec ChatGPT.

Si vous enchaînez les outils et les tâches répétitives, cet article devrait vous servir. Nous regroupons l’essentiel — installation, configuration, fonctions avancées — en une feuille de route complète.

C’est le 35ᵉ article de la série OpenClaw, article de synthèse : l’essentiel des 34 précédents pour construire vite une vision d’ensemble.

Chapitre 1 : Qu’est-ce qu’OpenClaw ?

1.1 Pas ChatGPT, un agent IA

Beaucoup demandent d’emblée : en quoi c’est différent de ChatGPT ?

J’ai compris avec un exemple :

Vous demandez à ChatGPT « range mes e-mails récents » : il explique ou vous renvoie du texte. Vous copiez-collez vous-même dans la boîte mail.

Vous demandez la même chose à OpenClaw : il ouvre la boîte, lit, classe, génère le rapport et vous l’envoie sur le téléphone.

C’est la différence entre chat passif et agent autonome.

OpenClaw exécute : outils (fichiers, web, code), mémoire (préférences, historique), planification (étapes vers l’objectif).

1.2 Pourquoi le choisir ?

Après trois mois d’usage, quatre points ressortent :

Déploiement local, données chez vous. Pas d’entraînement sur vos chats. Important pour du contenu sensible.

Coûts maîtrisés. Modèles légers pour les tâches simples, Claude ou GPT-4 pour le complexe. En pratique, souvent moins cher qu’un usage ChatGPT intensif.

Personnalisable. 53 skills officiels, plus la communauté. Vous pouvez écrire vos propres skills selon votre flux de travail.

Multi-canaux. Telegram, WhatsApp, Web UI, Gmail… Je passe surtout par Telegram : une consigne depuis n’importe où.

1.3 À quoi ressemble l’architecture ?

Schéma simplifié :

Vous → Channel (Telegram/WhatsApp) → Gateway → Agent → Tools/Skills

                                           Memory

Gateway : point d’entrée des messages.

Agent : comprend l’intention, planifie, appelle les outils.

Channels : dialogue sur plusieurs plateformes.

Tools : 26 outils cœur — fichiers, web, code, Git…

Skills : workflows packagés — 53 officiels, plus la communauté (briefing actus, revue de code, compte-rendu…).

Memory : préférences et contexte dans MEMORY.md.

Pour aller plus loin : « Architecture OpenClaw en profondeur : principes de la conception en trois couches et pratiques d’extension ».

1.4 Que peut-on en faire ?

Quelques usages fréquents :

Assistant personnel. Briefing actus le matin sur Telegram, agenda, e-mails, rappels.

Aide au développement. Revue de code, debug, docs ; recherche et documentation plus vite que seul.

Workflows automatisés. Sauvegardes planifiées, surveillance de sites, e-mails marketing — en langage naturel plutôt qu’en scripts maison.

Domotique. Avec Home Assistant : « Je rentre » → lumières et clim.

Chapitre 2 : Démarrage rapide — 10 minutes

2.1 Choisir le mode d’installation

Trois voies, par ordre de recommandation :

Script officiel (débutants)

Documentation d’installation :

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

Le script détecte l’OS, gère Node si besoin, installe le CLI. Ensuite, lancez l’assistant d’onboarding ci-dessous.

Installation globale npm

Si vous gérez déjà Node (officiel : Node 24, minimum 22.14+) :

npm install -g openclaw@latest
openclaw onboard --install-daemon

Vérifiez avec openclaw --version, openclaw doctor, openclaw gateway status.

Depuis les sources (contributeurs)

Flux officiel avec pnpm :

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

Sans link global : pnpm openclaw ... dans le dépôt (voir la doc Setup).

Pour un usage simple, script ou npm global suffisent. Détails dans les articles « guide d’installation » de la série.

2.2 Configuration de base

Après installation : fournisseurs de modèles et canaux.

Clés API

OpenClaw appelle des API (Anthropic, OpenAI, Google…). Recommandé : openclaw onboard en interactif ; sinon openclaw secret set. Évitez les clés longue durée en clair dans des dossiers synchronisés. Ordre de résolution : documentation officielle.

Configuration des canaux

Telegram reste le plus simple pour débuter : BotFather → token → assistant. Fichier principal ~/.openclaw/openclaw.json ; champs channels.telegram : doc Telegram. Les vieux tutos qui citent config.yaml sont génériques — privilégiez openclaw.json et la doc officielle.

WhatsApp et autres : pages Channels correspondantes. Console web : openclaw dashboard (Gateway actif).

Bases de sécurité

Au minimum :

  1. Permissions adaptées sur MEMORY.md et .env
  2. Pare-feu si déploiement serveur

Le chapitre 5 détaille la sécurité.

2.3 Première conversation

Démarrez et vérifiez le Gateway :

openclaw gateway status
# Débogage au premier plan (logs visibles) :
openclaw gateway

Avec la politique Telegram pairing par défaut : openclaw pairing approve telegram <CODE> (code ~1 h). Avec dmPolicy: "allowlist" et votre ID, vous pouvez éviter l’étape selon votre config. Voir la doc Telegram.

Envoyez un message à votre bot.

Premier skill : la mémoire

Souviens-toi : je me lève à 8 h, j'aime les actus tech, ma langue de travail est le chinois.

Consultez MEMORY.md : les préférences y sont. Les prochains échanges s’adaptent.

Faites-le travailler

Cherche les actus récentes sur OpenClaw et résume-les en 5 points.

Il cherche, lit, synthétise — sans intervention. Une fois ce ressenti éprouvé, difficile de revenir en arrière.

Chapitre 3 : Fonctions cœur — outils et skills

3.1 Les 26 outils cœur

Fichiers, réseau, code, etc. Exemples :

Fichiers

OutilFonction
read_fileLire un fichier local
write_fileÉcrire un fichier
execute_commandExécuter une commande shell
list_directoryLister un répertoire

Réseau

OutilFonction
web_searchRecherche web
fetch_urlRécupérer une page
scrapeParser la structure d’une page

Code

OutilFonction
execute_codeExécuter un extrait de code
git_operationsOpérations Git

Exemple : « Analyse la structure de ce projet » → list_directory, read_file, execute_code, puis synthèse. Une seule consigne de votre part.

3.2 Introduction aux skills

Les outils sont la brique ; les skills, des workflows prêts à l’emploi.

53 skills officiels, plus la communauté. Quelques incontournables :

memory — préférences et historique ; base de la personnalisation.

web_search — recherche, fetch, parsing enchaînés.

code_execution — Python, JavaScript ; données et prototypes.

Marchés de skills

  • ClawHub : marché officiel, installation en un clic
  • awesome-openclaw-skills : recensement GitHub, qualité variable

Installation :

openclaw skill install <skill_name>

Ou dans la configuration :

skills:
  - name: daily_news
    source: github
    repo: user/daily-news-skill

3.3 Développer un skill personnalisé

Si rien ne convient, écrivez le vôtre.

Un skill = configuration + appels d’outils. Exemple minimal :

name: my_skill
description: Mémoriser l'important
tools:
  - memory.write
  - memory.read
prompt: |
  Quand l'utilisateur dit « souviens-toi de XXX », appeler memory.write.
  Quand il demande ce qu'il a demandé de retenir, appeler memory.read.

Placez-le dans skills/, redémarrez OpenClaw.

Bonnes pratiques :

  1. Conditions de déclenchement claires
  2. Permissions minimales sur les outils
  3. Gestion d’erreurs si un outil échoue

Approfondir : article « guide de développement OpenClaw Skills » de la série.

Chapitre 4 : Niveau avancé — automatisation

4.1 Routage multi-modèles et coûts

Les frais API montent vite ; les tâches simples n’ont pas besoin de Claude ou GPT-4.

Pourquoi router ?

  • Todo, Q&R simples → GPT-3.5 ou Claude Haiku
  • Revue de code, raisonnement → GPT-4 ou Claude Sonnet
  • Cas très complexes → Claude Opus

Configuration

Clés réelles dans ~/.openclaw/openclaw.json et pages Models / Model Failover — ne copiez pas aveuglément des extraits config.yaml trouvés en ligne. Cas pratiques : article « gestion des coûts OpenClaw : stratégie de routage », vérifié contre la doc modèles.

Avec routage et repli, environ 40 % d’économie chez moi (selon les tâches, indicatif).

4.2 Tâches planifiées

Fonction préférée : Cron via openclaw cron add, persistance dans ~/.openclaw/cron/jobs.json (chemin local). Voir la série « guide Cronjob OpenClaw » et la doc cron.

Exemples

  1. Briefing actus à 8 h sur Telegram
  2. Rapport hebdo le vendredi après-midi
  3. Sauvegarde le dimanche matin

Avant : scripts + crontab. Maintenant : description en langage naturel.

4.3 Intégration multi-canaux

Plusieurs canaux en parallèle : consigne sur Telegram, réponse par e-mail si vous le configurez ainsi.

Canaux principaux

  • Telegram (le plus courant)
  • WhatsApp
  • Gmail
  • Web UI
  • Discord

Cas : hub de messages

  1. OpenClaw surveille plusieurs boîtes
  2. E-mail important → résumé sur Telegram
  3. Vous répondez sur Telegram → OpenClaw envoie l’e-mail

Moins de changements d’application.

4.4 Automatisation navigateur (nouveauté 2026.3)

Live Chrome Session Attachment : OpenClaw peut s’attacher à votre session Chrome.

Usages

  • Remplissage de formulaires
  • Pages nécessitant une connexion
  • Tests web automatisés
  • Vérifications planifiées de sites

Exemple de configuration

browser:
  enabled: true
  headless: false  # true pour exécution en arrière-plan
  user_data_dir: ~/.config/openclaw/chrome

Puis :

Ouvre GitHub et vérifie s'il y a de nouvelles Pull Requests.

Il lance ou reprend le navigateur, navigue, vérifie. Voir « OpenClaw 2026.3 avancé : nouvelles fonctionnalités et bonnes pratiques ».

Chapitre 5 : Sécurité et déploiement

5.1 Checklist sécurité

OpenClaw exécute des commandes et touche aux fichiers — la sécurité compte.

Clés API

Ne les mettez pas en dur dans les fichiers de config :

export ANTHROPIC_API_KEY=sk-ant-xxx

Ou workflow Secrets :

openclaw secret set ANTHROPIC_API_KEY

Chiffrement au repos, injection à l’exécution.

Bac à sable

Pour plus d’isolation, Docker :

sandbox:
  type: docker
  image: openclaw/sandbox:latest
  resource_limits:
    memory: 512M
    cpu: 0.5

Le code tourne dans le conteneur, pas sur l’hôte.

SELinux

2026.3 détecte SELinux. Sur CentOS, j’ai bloqué une demi-journée : SELinux empêchait l’accès réseau d’OpenClaw.

Checklist rapide

  • Clés via env ou Secrets
  • MEMORY.md et .env en chmod 600
  • Bac à sable Docker en production
  • SELinux / pare-feu vérifiés
  • Mises à jour régulières

Détails : « guide de renforcement sécurité OpenClaw » (série).

5.2 Comparer les modes de déploiement

ModeAvantagesInconvénientsCas d’usage
LocalSimple, gratuit, données localesMachine alluméePerso, tests
ServeurStable, accès distantMaintenance, coûtPetite équipe, prod
Cloud (ex. DigitalOcean)Déploiement rapideCoût, données cloudMise en ligne sans ops lourdes

Mon parcours

Local d’abord — veille = arrêt. Vieux portable en serveur — bruit et électricité. Aujourd’hui un petit VPS, quelques dollars par mois, stable depuis des mois.

Comparatif : article « comparaison des déploiements OpenClaw ».

5.3 Déploiement entreprise

Multi-utilisateurs

Mémoire et permissions par utilisateur :

users:
  - id: user1
    channels: [telegram, email]
    permissions: [read, write, execute]
  - id: user2
    channels: [web]
    permissions: [read]

Monitoring et logs

logging:
  level: info
  format: json
  output: /var/log/openclaw/app.log

À coupler avec Grafana ou équivalent.

Haute disponibilité

  1. Plusieurs instances + répartition de charge
  2. Persistance Memory en base
  3. Sauvegardes régulières config et données

Voir « Déploiement OpenClaw en entreprise : guide complet multi-utilisateurs… ».

Chapitre 6 : Parcours et ressources

6.1 Débutant (0-1 mois)

Objectif : faire tourner l’agent et des tâches simples.

Lecture

  1. Guide d’installation — suivre pas à pas
  2. Guide d’architecture — vision globale
  3. Guide de configuration — brancher Telegram

Pratique

  • Déploiement OK
  • Première conversation
  • Mémorisation des préférences
  • Un skill (ex. web_search)

Problèmes fréquents

  • Échec install : script officiel plutôt que sources
  • Telegram : token et réseau
  • API : clé et solde

6.2 Intermédiaire (1-3 mois)

Objectif : gagner du temps au quotidien.

Lecture

  1. Gestion des coûts / routage modèles
  2. Renforcement sécurité
  3. Guide Cronjob

Pratique

  • Routage multi-modèles
  • 2-3 tâches planifiées
  • Telegram + e-mail
  • Explorer ClawHub et la communauté

Conseil

La période où l’on abandonne souvent : la nouveauté passe, le gain temps n’est pas encore visible. Choisissez une tâche répétitive quotidienne (tri e-mails, rapport hebdo) et déléguez-la. Le motivation suit les résultats.

6.3 Expert (3 mois+)

Objectif : outil sur mesure.

Lecture

  1. Déploiement entreprise
  2. Développement de skills
  3. Code source officiel

Pratique

  • Skills personnalisés
  • Production
  • Optimisation perf et coûts
  • Contribution communauté (PR, tutos)

Pistes

  • Intégration profonde dans votre stack
  • Partage de skills
  • Contribution au projet

6.4 Ressources externes

Officiel

  • Documentation : docs.openclaw.ai
  • GitHub : github.com/openclaw/openclaw

Communauté

  • awesome-openclaw-skills
  • ClawHub

Tutoriels

  • freeCodeCamp « OpenClaw Full Tutorial for Beginners »
  • every.to « OpenClaw Comprehensive Guide »

Conclusion

OpenClaw vaut-il le temps d’apprentissage ?

Oui, si vous en avez assez des tâches répétitives, des allers-retours entre outils, et si vous voulez un assistant qui fait vraiment le travail.

Ce n’est pas magique du jour au lendemain : courbe d’apprentissage et temps de config. Une fois en place, beaucoup de choses peuvent être déléguées.

Trois actions immédiates :

  1. Choisissez un mode de déploiement — local, serveur ou cloud, selon ce qui vous arrange.
  2. Testez un skill — web_search ou memory pour sentir l’exécution autonome.
  3. Rejoignez la communauté — le projet évolue vite ; beaucoup à découvrir.

Questions ? Parcourez la série, ou ouvrez une issue GitHub. J’ai aussi buté sur pas mal de coins — échange bienvenu.

Guide de démarrage rapide OpenClaw

Installer OpenClaw et tenir la première conversation en 10 minutes

⏱️ Estimated time: 10 min

  1. 1

    Step 1: Installer OpenClaw

    Déploiement en une commande avec le script officiel :

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

    • macOS, Linux, Windows (WSL2 ; chemin d'installation Windows natif également documenté)
    • Gestion automatique des dépendances et du CLI
    • Après installation : `openclaw onboard --install-daemon` ; vérifier le Gateway avec `openclaw gateway status`
  2. 2

    Step 2: Configurer les clés API

    Utilisez l'assistant d'onboarding ou les commandes de secrets, par exemple :

    ```bash
    openclaw onboard --install-daemon
    # ou (exemple) écrire les clés via les commandes secret de la doc officielle
    ```

    • Prise en charge de Claude, OpenAI, Gemini, etc. (selon les options du CLI actuel)
    • Ne commitez pas de clés longue durée en clair dans Git ou les chats
  3. 3

    Step 3: Connecter Telegram

    1. Créez un bot via @BotFather et récupérez le token
    2. Liez Telegram avec `openclaw onboard`, ou éditez la section `channels.telegram` dans `~/.openclaw/openclaw.json` selon la doc

    • Doc Telegram : https://docs.openclaw.ai/channels/telegram
    • La politique DM par défaut est souvent pairing ; premier message privé : `openclaw pairing approve telegram <CODE>` côté gateway
    • WhatsApp, Discord et autres canaux : voir la doc Channels officielle
  4. 4

    Step 4: Première conversation

    Une fois démarré, envoyez sur Telegram :

    ```
    Souviens-toi : j'aime les actus tech, ma langue de travail est le chinois.
    ```

    • Vérifiez `MEMORY.md` pour confirmer la mémorisation
    • Essayez « cherche des actus OpenClaw » pour voir l'exécution autonome

FAQ

Quelle différence entre OpenClaw et ChatGPT ?
La différence clé est l'autonomie. ChatGPT est un outil de chat passif : conseils et texte. OpenClaw est un framework d'agent IA qui planifie, appelle des outils et exécute. Pour trier des e-mails, ChatGPT explique comment faire ; OpenClaw ouvre la boîte, lit, classe et vous envoie le rapport.
OpenClaw est-il payant ?
OpenClaw est gratuit et open source. Les coûts viennent des API de grands modèles :

• API Claude : facturation au token
• API OpenAI : facturation au token

Le routage multi-modèles peut réduire d'environ 40 % les frais — tâches simples en Haiku/GPT-3.5, tâches complexes en Sonnet/GPT-4.
Quels grands modèles OpenClaw prend-il en charge ?
Anthropic Claude (recommandé), OpenAI GPT, Google Gemini, modèles locaux via Ollama, etc. Définissez le modèle par défaut et les règles de routage dans la configuration pour basculer selon la complexité.
Quelle configuration pour déployer OpenClaw ?
Minimum :
• 1 cœur CPU
• 512 Mo RAM
• Réseau stable (accès API)

Recommandé :
• 2 cœurs CPU
• 1 Go RAM
• VPS ou cloud 24h/24

Un portable suffit pour les tests en local.
Les données OpenClaw sont-elles sécurisées ?
Les données restent en local, sans envoi vers des serveurs tiers. Points d'attention : 1) clés API via variables d'environnement ; 2) bac à sable Docker en production ; 3) mises à jour régulières. L'historique est dans `MEMORY.md` local — consultable et supprimable à tout moment.
Comment faire mémoriser mes préférences à OpenClaw ?
Dites-lui : « Souviens-toi, j'aime les actus tech ». Il enregistre dans `MEMORY.md`. Les prochains échanges en tiennent compte. Vous pouvez aussi éditer `MEMORY.md` directement.

10 min de lecture · Publié le: 18 mars 2026 · Mis à jour le: 27 juil. 2026

Commentaires

Connectez-vous avec GitHub pour laisser un commentaire

Easton BlogEaston Blog