Guide OpenClaw : installer un agent IA auto-hébergé

1. OpenClaw, c'est quoi exactement ?

OpenClaw est une passerelle auto-hébergée pour agents IA. Concrètement, vous lancez un seul programme — la « Gateway » — sur votre ordinateur ou un petit serveur, et ce programme fait le pont entre vos applications de messagerie et un assistant IA toujours disponible. Vous envoyez un message depuis votre téléphone, l'agent répond, agit, et exécute des tâches pour vous.

Le projet a été créé par Peter Steinberger (il s'appelait auparavant Clawdbot puis Moltbot). Il est devenu un phénomène début 2026, au point de dépasser React comme projet logiciel le plus étoilé sur GitHub. Il est distribué sous licence MIT, donc gratuit et auditable.

Ce qui le distingue d'un simple chatbot :

• Auto-hébergé : il tourne sur votre matériel, vos données restent chez vous. Pas de service tiers obligatoire.
• Multi-canal : une seule Gateway dessert Discord, Slack, Telegram, WhatsApp, Signal, iMessage, Microsoft Teams, Matrix et d'autres canaux en parallèle.
• Pensé pour les agents : utilisation d'outils, sessions isolées, mémoire, routage multi-agents.
• Flexible côté modèle : vous branchez un modèle cloud (Anthropic, OpenAI, Google) ou un modèle local via Ollama / LM Studio.

2. Agent autonome vs chatbot : la différence qui change tout

Un chatbot classique (ChatGPT, Claude dans le navigateur) est réactif : il attend votre prompt, répond, et oublie. Un agent comme OpenClaw est actif : il tourne en continu, peut être déclenché par des événements (un message, un webhook, une tâche planifiée), et exécute réellement des actions — lire et écrire des fichiers, lancer des commandes, appeler des API.

La Gateway fonctionne comme un démon avec un « battement de cœur » (heartbeat) : par défaut toutes les 30 minutes, l'agent consulte une liste de tâches et décide s'il doit agir ou simplement rester en veille. Des événements externes (webhooks, tâches cron, messages) peuvent aussi déclencher sa boucle d'action.

Pour situer OpenClaw face aux deux autres outils dont on parle le plus en 2026 :

3. Prérequis avant de commencer

Vous n'avez besoin que de trois choses :

• Node.js — version 24 recommandée, ou Node 22 LTS (22.19 minimum) pour la compatibilité.
• Une clé API chez votre fournisseur de modèle (Anthropic, OpenAI ou Google), ou un modèle local via Ollama si vous voulez tout garder hors ligne.
• 5 minutes et un terminal (macOS, Linux ou Windows).

4. Installation pas à pas

npm install -g openclaw@latest

openclaw onboard --install-daemon

openclaw dashboard

C'est tout. À ce stade, OpenClaw utilise son runtime intégré avec une session par interlocuteur. La configuration vit dans le fichier ~/.openclaw/openclaw.json — si vous ne le touchez pas, le comportement par défaut s'applique.

5. Connecter un canal de messagerie

Le canal le plus rapide à brancher est Telegram : vous créez un bot via @BotFather, vous récupérez un token, et vous le renseignez pendant l'onboarding. Vous pouvez ensuite parler à votre agent depuis votre téléphone, comme à un contact.

Pour WhatsApp, Slack, Discord, Signal et les autres, chaque canal a sa procédure (jeton, appairage, ou plugin dédié). Le principe reste le même : la Gateway centralise tous les canaux dans un seul processus.

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+33XXXXXXXXX"],
      "groups": { "*": { "requireMention": true } }
    }
  },
  "messages": { "groupChat": { "mentionPatterns": ["@openclaw"] } }
}

6. Les Skills et le registre ClawHub

La force d'OpenClaw, ce sont les skills : des fichiers SKILL.md contenant un en-tête YAML et des instructions en langage naturel. Chaque skill apprend à l'agent à accomplir une tâche précise (trier des emails, publier sur un réseau, interroger une API…).

• La communauté a publié des milliers de skills, partagés via ClawHub, un registre que l'agent peut interroger automatiquement.
• Le format est portable et compatible avec les conventions de Claude Code et Cursor.
• Si un skill n'existe pas, vous pouvez décrire la tâche à votre agent et lui demander d'en rédiger un.
• Les skills se trouvent dans ~/.openclaw/workspace/skills/<skill>/SKILL.md. Des fichiers de prompt (AGENTS.md, SOUL.md, TOOLS.md) définissent le comportement global.

7. Sécurité et sandbox : le point critique pour une PME

Un agent qui peut exécuter des commandes sur votre machine est puissant — et potentiellement dangereux. Voici les garde-fous à activer avant tout usage professionnel :

• Listes d'autorisation (allowFrom) et mention obligatoire dans les groupes, pour qu'un inconnu ne puisse pas piloter l'agent.
• Sandbox : par défaut, les outils s'exécutent sur l'hôte pour la session principale. Pour les sessions non principales (groupes, canaux partagés), activez agents.defaults.sandbox.mode: "non-main" afin de les isoler dans un conteneur. Le backend Docker est utilisé par défaut ; des backends SSH et OpenShell existent aussi.
• Politiques d'outils et validations : autorisez la lecture des emails mais exigez une approbation avant l'envoi, permettez la lecture de fichiers mais bloquez les suppressions. Le niveau d'autonomie est un choix de configuration.

8. Cinq cas d'usage concrets pour une PME B2B

Au-delà de la démo, voici où OpenClaw crée de la valeur dans un contexte commercial :

1. Triage de la boîte mail : l'agent classe les emails entrants, identifie les demandes commerciales et vous résume l'essentiel sur Telegram chaque matin.
2. Relances intelligentes : il repère les devis sans réponse et prépare un brouillon de relance contextualisé, que vous validez d'un mot.
3. Brief avant rendez-vous : avant un call, il rassemble l'historique du contact et vous envoie une synthèse.
4. Veille : surveillance d'un secteur, d'un concurrent ou d'un mot-clé, avec digest planifié.
5. Qualification de leads : à partir d'un formulaire ou d'un email entrant, l'agent enrichit, score et oriente vers le bon pipeline.

9. Brancher OpenClaw sur Pipedrive et Make.com

C'est ici que l'agent rejoint votre système commercial. Deux schémas d'intégration complémentaires :

OpenClaw déclenche Make.com

Plutôt que de donner à l'agent un accès direct (et risqué) à votre CRM, faites-lui appeler un webhook Make.com. Make orchestre ensuite l'action fiable côté Pipedrive (créer un deal, mettre à jour un contact, déplacer une carte). L'IA décide, Make exécute — c'est la combinaison la plus robuste en production.

Make.com déclenche OpenClaw

À l'inverse, un scénario Make peut envoyer un événement à l'agent (nouveau lead, email reçu) pour qu'il rédige, analyse ou score, puis renvoie le résultat dans le flux. L'agent devient la « brique intelligence » de vos automatisations.

10. Limites et coûts réels

• Sécurité = votre responsabilité : la puissance d'OpenClaw implique une vraie discipline de configuration. C'est le principal point de vigilance.
• Coût du modèle : le logiciel est gratuit, mais chaque action consomme des tokens. Comptez quelques dizaines d'euros par mois en usage modéré via API, ou 0 € avec un modèle local (au prix de la puissance machine).
• Maintenance : un projet jeune qui évolue vite ; prévoyez des mises à jour régulières.
• Courbe d'apprentissage : l'installation est simple, mais en tirer une vraie valeur métier demande de concevoir de bons skills.

Julien Bréal — Fondateur de Lab0, expert CRM Pipedrive & automatisation Make.com. J'accompagne les PME françaises dans le déploiement d'agents IA reliés à leur système commercial. Voir l'offre déploiement d'agents IA →

11. Questions fréquentes

Aller plus loin