Installer OpenClaw et déployer son premier agent IA en local : guide complet

OpenClaw est une plateforme d'agents IA autonomes open source. Contrairement aux solutions cloud, tout s'exécute en local sur votre machine : vos données ne quittent jamais votre réseau, vous contrôlez intégralement ce que font vos agents.

Ce guide explique comment installer OpenClaw et déployer votre premier agent opérationnel, sur macOS, Linux ou Windows.

ThalerTech est la référence francophone OpenClaw. Nous l'utilisons en production pour tous les agents déployés chez nos clients, et nous formons les équipes qui veulent le maîtriser en interne.

Qu'est-ce qu'OpenClaw exactement ?

OpenClaw est un runtime d'agents IA autonomes. Concrètement, il permet à un modèle de langage (Claude, GPT-4, Gemini) d'agir dans le monde réel : lire et écrire des fichiers, appeler des APIs, envoyer des emails, surveiller des calendriers, exécuter des scripts.

Ce qui distingue OpenClaw d'un simple wrapper autour d'un modèle de langage :

Le modèle de compétences (skills). Chaque capacité de l'agent est encapsulée dans un skill réutilisable. Vous installez uniquement ce dont vous avez besoin : email, calendrier, CRM, Make, browser automation.

L'exécution locale. Aucune donnée ne passe par un serveur tiers. L'agent tourne sur votre Mac, votre serveur Linux ou votre Raspberry Pi.

La persistance de contexte. L'agent se souvient des conversations passées et de l'état de ses tâches entre deux sessions, via des fichiers de mémoire simples en Markdown.

L'extensibilité. Les skills sont des fichiers SKILL.md lisibles par n'importe qui. Vous pouvez en créer de nouveaux en décrivant leur fonctionnement en langage naturel.

Quels sont les prérequis ?

Avant d'installer OpenClaw, vous avez besoin de :

Node.js 18 ou supérieur. OpenClaw tourne sur Node.js. Si vous ne l'avez pas, téléchargez-le sur nodejs.org. Vérifiez votre version avec `node --version` dans le terminal.

npm. Inclus avec Node.js. Vérifiez avec `npm --version`.

Une clé API pour un modèle de langage. OpenClaw utilise Claude (Anthropic) par défaut. Vous pouvez aussi configurer OpenAI ou Gemini. Une clé API Claude Sonnet est suffisante pour démarrer.

Un terminal. Sur macOS : Terminal ou iTerm2. Sur Linux : votre terminal habituel. Sur Windows : PowerShell ou WSL2 (recommandé).

Installation pas à pas

Sur macOS et Linux

Ouvrez votre terminal et lancez la commande d'installation automatique :

```bash npm install -g openclaw ```

Une fois installé, vérifiez que tout fonctionne :

```bash openclaw --version ```

Vous devriez voir le numéro de version s'afficher. Si ce n'est pas le cas, vérifiez que le dossier npm global est dans votre PATH.

Sur Windows

Sur Windows, nous recommandons WSL2 (Windows Subsystem for Linux) pour une compatibilité optimale. Installez Ubuntu via le Microsoft Store, puis suivez les instructions Linux ci-dessus dans votre terminal WSL2.

Si vous préférez une installation native Windows, npm fonctionne aussi dans PowerShell, mais certains skills nécessitent des ajustements de configuration.

Configuration initiale

Au premier lancement, OpenClaw crée un dossier workspace et vous demande votre clé API :

```bash openclaw ```

Renseignez votre clé API Claude (format `sk-ant-...`) quand elle est demandée. OpenClaw la stocke localement, jamais en dehors de votre machine.

Configurer votre premier agent

Le workspace OpenClaw contient plusieurs fichiers que vous pouvez personnaliser :

SOUL.md : définit la personnalité et le comportement de votre agent. Modifiez-le pour adapter le ton, la langue par défaut (mettez "Répondre en français") et les règles de comportement.

USER.md : informations sur vous que l'agent doit connaître (votre nom, votre fuseau horaire, vos préférences).

MEMORY.md : mémoire long terme de l'agent. Il la met à jour automatiquement au fil des sessions.

Un agent minimal fonctionnel ne nécessite que ces 3 fichiers configurés. Vous pouvez démarrer une conversation avec lui immédiatement.

Installer des skills

Les skills étendent les capacités de votre agent. OpenClaw dispose d'un registry de skills sur ClawHub.

Pour installer le skill email (himalaya) :

```bash openclaw install himalaya ```

Pour installer le skill Make (automatisation) :

```bash openclaw install make ```

Pour voir tous les skills disponibles :

```bash openclaw search ```

Après l'installation, chaque skill dispose d'un fichier SKILL.md qui explique à l'agent comment l'utiliser. Vous n'avez pas besoin de le lire : l'agent le lit lui-même au démarrage.

Exemples d'agents simples à déployer

Agent de veille email

Avec le skill himalaya configuré, votre agent peut surveiller votre boite email, trier les messages par priorité et vous envoyer un résumé quotidien des emails importants.

Configuration : renseignez vos identifiants IMAP/SMTP dans la configuration himalaya, puis dites à votre agent : "Chaque matin à 8h, lis mes emails des dernières 24h et résume les 5 plus importants."

Agent de suivi de projet

Avec le skill Notion ou Google Sheets, l'agent peut surveiller l'avancement de vos projets, détecter les tâches en retard et vous alerter proactivement.

Agent de relances commerciales

Couplé au skill Make, l'agent peut piloter vos scénarios de relance Make selon une logique décisionnelle : "Relance ce prospect si le devis a été ouvert mais pas signé depuis 5 jours."

Agent d'automatisation Make

OpenClaw peut appeler des webhooks Make directement. Votre agent prend une décision et déclenche le scénario Make approprié, sans intervention humaine. C'est l'architecture que nous déployons chez nos clients pour les cas d'usage commerciaux et SAV.

Connecter OpenClaw à Make

La connexion entre OpenClaw et Make se fait via webhooks :

1. Dans Make, créez un scénario avec un module "Webhooks > Custom webhook" 2. Copiez l'URL du webhook généré 3. Dans votre agent OpenClaw, configurez le skill Make avec cette URL 4. L'agent peut désormais déclencher le scénario Make depuis une conversation ou une tâche automatisée

Pour les configurations complexes (plusieurs scénarios, conditions de déclenchement), nos formations Make + OpenClaw couvrent l'intégralité du setup. Voir les formations.

Déploiement sur un serveur (usage permanent)

Si vous voulez que votre agent tourne 24h/24, plusieurs options existent :

Mac mini ou MacBook Air avec capot fermé. La solution la plus simple pour un usage personnel ou une petite équipe. Configurez macOS pour ne jamais se mettre en veille.

VPS Linux. Installez OpenClaw sur un VPS chez OVH, Hetzner ou Scaleway (2 vCPU, 2 Go RAM suffisent pour un agent léger). Coût : 3 à 8 euros par mois.

Raspberry Pi 4. Pour les usages domestiques ou les petits projets. Le Pi4 avec 4 Go de RAM fait tourner OpenClaw sans problème.

Dans tous les cas, l'installation est identique. La différence est uniquement dans l'infrastructure hôte.

FAQ : installer et configurer OpenClaw

Q : OpenClaw est-il vraiment gratuit ? R : Oui. OpenClaw est open source (MIT). Vous payez uniquement les tokens API du modèle de langage que vous utilisez. Avec Claude Sonnet 3.5, le coût d'usage quotidien d'un agent actif est généralement inférieur à 1 euro par jour pour un usage personnel.

Q : Faut-il savoir coder pour utiliser OpenClaw ? R : Non. La configuration de base et l'utilisation quotidienne ne nécessitent aucune compétence de développement. Créer de nouveaux skills personnalisés nécessite de savoir décrire un outil en Markdown, ce que la plupart des utilisateurs peuvent faire.

Q : OpenClaw fonctionne-t-il avec des modèles autres que Claude ? R : Oui. OpenClaw supporte Claude (Anthropic), GPT-4 (OpenAI) et Gemini (Google). Le modèle se configure dans les paramètres du gateway. Nous recommandons Claude Sonnet pour le meilleur rapport qualité/coût/performance.

Q : Mes données sont-elles vraiment privées ? R : Avec un déploiement local, oui. Vos fichiers de mémoire, vos emails traités et vos conversations ne quittent jamais votre machine. La seule donnée qui sort est le prompt envoyé à l'API du modèle de langage (Claude, OpenAI ou autre), chiffré en transit.

Q : Comment mettre OpenClaw à jour ? R : Avec une simple commande npm : `npm update -g openclaw`. Nous recommandons de vérifier les notes de version avant chaque mise à jour majeure.

Q : Où trouver de l'aide si je suis bloqué pendant l'installation ? R : La communauté OpenClaw est active sur Discord (lien dans le README). ThalerTech propose aussi des sessions d'accompagnement à l'installation dans le cadre de ses formations. Pour les entreprises, notre Diagnostic IA inclut une session technique de mise en route. Démarrer le Diagnostic IA.

Q : Peut-on utiliser OpenClaw en équipe ? R : Oui. OpenClaw supporte plusieurs configurations multi-agents et multi-utilisateurs. Chaque membre de l'équipe peut avoir son propre agent ou partager un agent commun. La configuration multi-agents sort du scope de ce guide et est couverte dans nos formations avancées.