Après avoir agité la communauté open source mondiale, l'agent IA autonome OpenClaw s'installe désormais sur nos machines personnelles. Entre la promesse d'un véritable assistant omniscient et les questions légitimes de cybersécurité, la réalité est plus nuancée — et bien plus intéressante. De l'installation sur un PC classique à la configuration sécurisée sur VPS, ce guide détaille comment mettre en place cet outil puissant sans compromettre votre vie privée ni votre sécurité.
OpenClaw (anciennement ClawdBot, renommé à la suite de frictions juridiques avec Anthropic) n'est pas un chatbot de plus. C'est un agent au sens plein du terme : il ne se contente pas de répondre à vos questions, il agit, exécute du code, prend des initiatives et est même capable de développer ses propres fonctionnalités. Lorsque je lui ai demandé s'il était possible d'intégrer une conversation vocale, il a identifié les API disponibles, écrit l'intégration, configuré le service — et dix minutes plus tard, la fonctionnalité fonctionnait, sans que j'aie modifié une seule ligne de code.
Depuis son lancement, le projet a connu une progression spectaculaire : plus de 250 000 étoiles sur GitHub, ce qui en fait le premier projet logiciel de l'histoire de la plateforme à dépasser React et Linux en termes d'adoption. En trois semaines seulement, il a atteint un niveau de diffusion que Linux a mis trente ans à construire. Jensen Huang, PDG de NVIDIA, lors de la conférence Morgan Stanley TMT, a résumé l'événement en ces termes : il s'agirait selon lui de la sortie logicielle la plus importante de tous les temps. OpenClaw concrétise enfin le concept d'assistant personnel de type J.A.R.V.I.S hébergé sur votre propre machine — avec toutes les nuances que ce guide s'attache à détailler.
À l'attention des lecteurs qui commenteraient sans avoir lu l'article : oui, il s'agit d'une IA disposant d'un accès à votre machine. Non, elle ne va pas « en prendre le contrôle ». Oui, elle dépend d'une API cloud — sauf si vous optez pour un modèle 100 % local, ce que ce guide explique en détail. Non, son usage ne réduira pas vos compétences, pas plus qu'Excel n'a rendu les comptables moins compétents. Oui, des risques de sécurité existent, et une section entière leur est consacrée. Non, cet outil n'est pas réservé aux développeurs expérimentés.
J'ai hésité à rédiger ce guide. Après des dizaines d'heures à configurer, casser, reconfigurer et finalement maîtriser cet outil, l'idée de tout partager n'était pas évidente. Puis j'ai conclu que si je ne le faisais pas, quelqu'un d'autre le ferait — mais avec moins de rigueur. Donner un accès shell complet à une IA, même basée sur les excellents modèles de Claude ou OpenAI, reste une démarche qui exige méthode et précaution. Ce guide vous propose la marche à suivre la plus fiable pour installer, configurer et sécuriser OpenClaw, que vous soyez sous Windows, macOS ou Linux.
Ce que j'ai mis en place en quelques jours : des exemples concrets
Avant d'entrer dans les détails techniques, voici quelques réalisations concrètes que j'ai pu mettre en place en quelques jours seulement, afin d'illustrer ce qu'OpenClaw permet réellement :
- Un assistant disponible 24h/24 via Discord : un serveur privé avec des canaux dédiés par projet, par sujet et par type de tâche. Je lui adresse des messages depuis mon téléphone ou mon ordinateur, où que je sois.
- Une veille technologique et IA automatisée : chaque matin, l'agent agrège 41 flux RSS, parcourt Reddit, X/Twitter et Google News, supprime les doublons, évalue la pertinence des sujets et m'envoie un briefing classé par ordre d'intérêt sur Discord.
- Un détecteur de tendances Google Discover : lorsque trois sources ou plus publient sur le même sujet en moins de deux heures, l'agent me notifie. C'est un signal fort indiquant qu'un sujet est sur le point d'émerger massivement.
- Le suivi de mes projets GitHub : vérification du statut git, alertes sur les builds cassés, suivi des pull requests — sans ouvrir un navigateur.
- Un agent vocal : via ElevenLabs, je parle à mon Mac Mini qui me répond, avec le même contexte que sur Discord.
- La gestion de mon agenda et de mes e-mails : Google Calendar et Gmail — l'agent résume mes messages non lus, me rappelle les rendez-vous et signale les urgences.
- L'analyse d'images : envoyez une capture d'écran d'un message d'erreur ou d'un schéma technique, l'agent l'analyse directement sans que vous ayez besoin de décrire le problème.
- Les messages vocaux entrants : la transcription est automatique depuis Discord ou Telegram, et l'agent peut également répondre en vocal.
- Un backup automatique quotidien : commit et push de l'ensemble du workspace vers un dépôt privé. En cas de panne, tout est récupérable en dix minutes.
- Un mode proactif : une partie des tokens est allouée à des tâches de fond — organisation de la mémoire, vérification de l'état des projets, suggestions d'amélioration. Il arrive que je commence ma journée avec des propositions pertinentes que je n'avais pas demandées.
Tout cela depuis Discord, Telegram ou n'importe quel canal de messagerie configuré, sans nécessairement ouvrir votre ordinateur.
Pourquoi ne pas se contenter de ChatGPT ou Claude.ai ?
La question est légitime. ChatGPT et Claude.ai sont d'excellents outils dans leur usage : vous posez une question, ils répondent. Mais il s'agit d'un dialogue passif — vous devez être présent, formuler votre demande, attendre la réponse et relancer si nécessaire.
OpenClaw est un agent. Il dispose d'un accès à votre système de fichiers, votre terminal, votre navigateur et vos API. Il peut agir de manière autonome : exécuter un script à 3h du matin, vérifier vos e-mails toutes les heures, surveiller vos builds, vous envoyer un résumé sur Discord pendant que vous dormez. Il dispose également d'une mémoire persistante : il sait qui vous êtes, connaît vos projets et se souvient de ce que vous lui avez dit il y a trois semaines. Et il s'améliore au fil du temps, à mesure que vous enrichissez ses fichiers de contexte.
ChatGPT est un interlocuteur. OpenClaw est un collaborateur. La différence fondamentale, c'est l'autonomie. Ce concept a d'ailleurs convaincu bien au-delà de la communauté open source : Microsoft a lancé Copilot Tasks, sa propre réponse à OpenClaw, intégrée à l'écosystème Microsoft 365. La différence principale : Copilot Tasks fonctionne dans le cloud de Microsoft, pas chez vous. À vous d'évaluer si c'est un avantage ou une contrainte selon votre situation.
À qui s'adresse ce guide ?
OpenClaw est un outil expérimental. Puissant, mais expérimental. Ce guide s'efforce de rendre l'installation aussi accessible que possible, mais soyons clairs : vous devrez ouvrir un terminal. Pas pour coder — simplement pour lancer l'installation (une ligne à copier-coller) et ponctuellement pour quelques commandes de maintenance.
Une fois installé, tout passe par votre messagerie : Discord, Telegram, WhatsApp… Le terminal n'est plus nécessaire au quotidien. Si copier-coller une commande vous semble faisable, ce guide est fait pour vous. Vous n'avez pas besoin d'être développeur. Le reste, c'est votre agent qui s'en charge.
Comptez 15 à 30 minutes pour une installation fonctionnelle (installation, onboarding, premier message). Une à deux heures si vous souhaitez configurer Discord, les crons et les fichiers de mémoire correctement. Et quelques jours d'usage pour que l'agent commence à vraiment vous connaître. Si vous bloquez à n'importe quelle étape, collez le message d'erreur dans ChatGPT, Claude ou Gemini — ils savent tous déboguer une installation Node.js et OpenClaw.
Combien ça coûte ?
OpenClaw lui-même est gratuit et open source. Ce qui représente un coût, c'est le modèle IA que vous y connectez. Trois approches sont possibles :
- L'abonnement à forfait
- La plus simple pour démarrer. Un abonnement Claude Pro (~18 €/mois) ou Claude Max (~90 € ou ~185 €/mois selon le niveau) offre un quota mensuel prévisible. C'est ce que je recommande en première approche : budget maîtrisé, sans mauvaise surprise en fin de mois. ChatGPT Plus (~22 €/mois) est également compatible.
- L'API à la consommation
- Plus flexible, mais la facture peut rapidement monter. Vous payez au token consommé. En usage quotidien modéré (conversations, quelques automatisations), comptez entre 5 et 30 €/mois. En usage intensif avec un modèle haut de gamme comme Opus, la facture peut dépasser 100 à 150 € sans optimisation. Les heartbeats, les crons, les sous-agents — tout consomme des tokens.
- La solution 100 % gratuite
- Tout à fait envisageable. Google propose un quota API Gemini généreux (250 000 tokens par jour, gratuit). Ollama fait tourner des modèles locaux sans aucun coût au-delà de l'électricité. Moins puissant qu'Opus ou GPT-5, mais tout à fait fonctionnel pour débuter ou pour des usages modérés.
Concernant le matériel : aucun frais si vous utilisez votre machine principale. De 5 à 10 €/mois pour un VPS. Entre 150 et 300 € en achat unique pour un Mac Mini d'occasion.
PC principal ou machine dédiée ?
La question se pose dès lors que vous souhaitez un agent disponible en permanence.
Sur votre machine principale, OpenClaw s'installe en tant que daemon (launchd sur macOS, systemd sur Linux). Il démarre au boot, tourne en arrière-plan et consomme très peu de ressources au repos. C'est la configuration la plus simple pour commencer. Inconvénient : si votre machine est en veille ou éteinte, l'agent l'est aussi.
Sur un Mac Mini, un NUC ou un petit PC dédié, vous disposez d'un agent 24h/24, 7j/7. Idéal si vous souhaitez une réactivité permanente : un e-mail urgent au milieu de la nuit, un monitoring de build qui doit vous alerter immédiatement. Comptez entre 150 et 300 € pour une machine d'occasion largement suffisante.
Sur un VPS (Hetzner, OVH…), c'est la solution la moins coûteuse pour du 24/7 (5 à 10 €/mois), mais vous perdez l'accès au système de fichiers local, à la caméra et aux outils de capture d'écran. Suffisant pour un usage messagerie, veille et monitoring.
Sur un Raspberry Pi 5 (4 Go de RAM minimum), c'est fonctionnel. Avec une API distante (Anthropic, OpenAI…), les réponses sont rapides, le Pi se contentant de relayer les requêtes.
Le cas du Mac Mini M4 Pro
Depuis le lancement d'OpenClaw, le Mac Mini s'est imposé comme la machine de référence pour héberger un agent IA personnel. À tel point que les modèles haute mémoire (24 et 32 Go) affichent plusieurs semaines de délai de livraison sur l'Apple Store américain, et que les Mac Studio 64/128 Go sont passés de 14 à 54 jours d'attente en un mois, selon TechRadar. Business Insider parle d'un véritable « moment Mac Mini » porté par la vague OpenClaw.
Pourquoi le Mac Mini en particulier ? Son format compact, sa consommation au repos très faible (~10 W), le Neural Engine d'Apple Silicon, et surtout l'architecture mémoire unifiée — jusqu'à 48 Go partagés entre le CPU et le GPU — permettent de faire tourner des modèles locaux de 35 milliards de paramètres quantifiés sans GPU dédié. Ajoutez à cela un fonctionnement totalement silencieux en usage normal, et vous avez une machine qui tourne en permanence sans se faire remarquer.
Ma recommandation : commencez sur votre machine principale. Si vous accrochez, investissez dans une machine dédiée. Le Mac Mini M2 avec 8 Go de RAM fait parfaitement l'affaire pour démarrer.
Installation
Prérequis
- Node.js 22 ou supérieur
- Un terminal
- Une clé API selon votre fournisseur (Anthropic, OpenAI, Google…) ou un compte Claude Pro/Max pour l'authentification OAuth
Voici comment installer Node.js selon votre système d'exploitation :
| Système | Méthode recommandée |
|---|---|
| macOS | brew install node ou nodejs.org |
| Windows | winget install OpenJS.NodeJS.LTS dans PowerShell |
| Linux (Ubuntu/Debian) | Voir la section Linux ci-dessous |
| Le script d'installation d'OpenClaw détecte et installe Node automatiquement, mais il est préférable de le faire en amont pour s'assurer d'une installation propre. | |
Installation sur macOS
Une seule commande à lancer dans le terminal :
curl -fsSL https://openclaw.ai/install.sh | bash
Le script installe Node.js si nécessaire, puis lance automatiquement l'assistant de configuration (onboarding). Celui-ci vous proposera d'installer le daemon launchd — acceptez pour qu'OpenClaw démarre automatiquement à chaque démarrage de la machine.
Installation sur Linux (Ubuntu/Debian)
La même commande fonctionne :
curl -fsSL https://openclaw.ai/install.sh | bash
L'onboarding se lance automatiquement. Le daemon systemd démarre au boot et redémarre en cas de crash. Si vous préférez une installation manuelle :
npm install -g openclaw@latest
openclaw onboard --install-daemon
Note pour les VPS avec moins de 2 Go de RAM — Ajoutez du swap avant de commencer :
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
Installation sur Windows
La méthode recommandée passe par WSL2, qui offre un environnement Linux complet et une compatibilité maximale avec l'ensemble des outils et fonctionnalités :
Dans PowerShell en mode administrateur — installer WSL2 avec Ubuntu :
wsl --install -d Ubuntu
Après redémarrage, dans le terminal Ubuntu :
curl -fsSL https://openclaw.ai/install.sh | bash
Une fois dans WSL2, vous bénéficiez d'un environnement Linux à part entière. L'expérience est identique. Un installeur PowerShell natif existe également :
iwr -useb https://openclaw.ai/install.ps1 | iex
Certains outils et fonctionnalités Linux ne fonctionneront pas sans WSL2. L'installeur PowerShell natif est à réserver aux situations où WSL2 n'est pas disponible.
Configuration guidée : l'onboarding wizard
L'onboarding se lance automatiquement à la fin de l'installation. Pour le relancer à tout moment (changement de fournisseur, ajout d'un canal…), utilisez la commande openclaw onboard. Voici les principales étapes.
Gateway mode
Deux options : local ou remote. Choisissez local. Le gateway tourne sur votre machine, sur le port 18789. Votre configuration, votre mémoire et vos fichiers restent chez vous. Les messages envoyés au modèle transitent par l'API du fournisseur choisi (Anthropic, OpenAI, Google…) — sauf si vous utilisez un modèle 100 % local. Le mode remote existe pour connecter un client à un gateway distant (VPS, autre machine), mais pour un usage personnel sur une seule machine, il n'est pas nécessaire.
Authentification et choix du modèle
L'un des points forts d'OpenClaw réside dans son agnosticisme total vis-à-vis des modèles. Vous n'êtes enfermé dans aucun écosystème. Anthropic, OpenAI, Google, Mistral, Meta, xAI, des modèles locaux via Ollama, un serveur LM Studio sur votre réseau, ou tout provider compatible OpenAI — tout se connecte. Il est même possible de combiner les fournisseurs : un modèle principal chez Anthropic, des sous-agents chez Google et un fallback local via Ollama.
Le wizard vous propose les fournisseurs les plus courants :
- Anthropic — clé API sur console.anthropic.com, ou OAuth avec un abonnement Claude Pro/Max
- OpenAI — clé API sur platform.openai.com
- Google — clé API sur aistudio.google.com — quota gratuit généreux
- Ollama — aucune clé requise, 100 % local et gratuit
- OpenRouter — une seule clé pour accéder à des dizaines de modèles
- Custom Provider — tout endpoint compatible OpenAI ou Anthropic (LM Studio, vLLM, Together AI, Groq, Fireworks…)
L'importance de la hiérarchie des modèles
OpenClaw n'utilise pas un seul modèle mais plusieurs en parallèle, chacun avec un rôle défini. La règle d'or : votre modèle principal (l'orchestrateur) doit être le plus performant que votre budget vous permette.
Pourquoi ? Parce que c'est lui qui comprend votre demande et décide quoi en faire, choisit les outils à utiliser et dans quel ordre, délègue les sous-tâches aux bons agents, synthétise les résultats et respecte vos règles de configuration. Un modèle peu performant en orchestrateur, c'est un peu comme confier la coordination de dix experts seniors à un chef de projet sans expérience : la coordination sera défaillante, quelles que soient les compétences individuelles.
| Rôle | Fonction | Exemples de modèles |
|---|---|---|
| Orchestrateur (principal) | Comprend, décide, délègue, synthétise | Claude Opus 4.6, GPT-5, Gemini 3.1 Pro |
| Exécutant code (sous-agent) | Écrit, débogue, refactorise du code | Claude Sonnet 4.6, Codestral, DeepSeek Coder |
| Recherche web (outil natif) | Cherche et synthétise des sources récentes | Perplexity Sonar Pro |
| Tâches légères (sous-agent) | Résumés, formatage, tâches simples | Claude Haiku 4.5, Gemini 3 Flash, Llama 4 Scout |
| Fallback local (secours) | Prend le relais si l'API est indisponible | Ollama (Qwen, Mistral, Llama) |
| L'orchestrateur spawne automatiquement des sous-agents sur des modèles plus légers pour les tâches spécifiques, optimisant ainsi coût et vitesse. | ||
Pour démarrer, configurez le modèle le plus performant que votre budget autorise en tant que modèle principal. Avec un abonnement Claude Max, optez pour Opus 4.6. Sinon, Sonnet 4.6 fait un excellent orchestrateur. Vous pouvez modifier le modèle à tout moment :
openclaw config set agents.defaults.model.primary "anthropic/claude-sonnet-4-6"
Choix du canal de messagerie
C'est à cette étape que vous définissez comment vous communiquerez avec votre agent. Le wizard propose les canaux les plus populaires : Telegram (le plus simple pour démarrer), WhatsApp (pairing par QR code), Discord (le plus complet pour un usage avancé), Signal, Slack, iMessage, IRC, Matrix, Teams, Twitch, Line, Google Chat…
Si vous hésitez : Telegram pour démarrer rapidement, Discord si vous souhaitez le setup le plus complet. La plupart des canaux se connectent après l'installation via :
openclaw channels login --channel <nom>
Sécurité et verrouillage de l'agent
OpenClaw ne répond pas à n'importe qui. Le système de sécurité repose sur deux mécanismes principaux.
L'allowlist et le système de pairing
Par défaut, OpenClaw fonctionne en mode pairing : seuls les identifiants explicitement autorisés (votre numéro WhatsApp, votre user ID Telegram ou Discord…) peuvent interagir avec l'agent. Si une personne non autorisée envoie un message, le bot lui retourne un code de pairing à 8 caractères, mais ne traite pas sa demande. C'est à vous de valider :
# Voir les demandes de pairing en attente
openclaw pairing list telegram
openclaw pairing list discord
# Approuver une demande
openclaw pairing approve telegram ABCD1234
openclaw pairing approve discord WXYZ5678
Les codes expirent après 1 heure. Un maximum de 3 demandes en attente par canal est autorisé. Résultat : même si quelqu'un connaît l'adresse de votre gateway, il ne peut rien faire sans figurer dans l'allowlist.
L'audit de sécurité intégré
OpenClaw embarque un outil d'audit automatique qui analyse votre configuration et signale les failles courantes : permissions de fichiers trop permissives, groupes ouverts, authentification manquante, navigateur exposé…
openclaw security audit
openclaw security audit --deep
openclaw security audit --fix
L'option --fix applique les corrections sans risque : resserrement des permissions de fichiers, activation de la rédaction des données sensibles dans les logs. Elle ne touche pas à vos tokens et ne désactive aucun outil. Lancez cet audit une fois après l'installation, puis après chaque modification de configuration.
Les approbations d'exécution
Pour conserver un contrôle humain sur les actions de l'agent, activez les exec approvals. L'agent vous demande la permission avant d'exécuter une commande sur votre machine — vous voyez la commande exacte, le répertoire concerné, et vous validez ou refusez.
Trois modes sont disponibles : deny (tout bloquer), allowlist (n'autoriser que les commandes validées) et full (tout autoriser — le réglage par défaut). Le mode recommandé pour démarrer est allowlist avec ask: "on-miss" — l'agent sollicite votre accord pour chaque nouvelle commande, et vous pouvez répondre « toujours autoriser » pour les commandes que vous reconnaissez.
Les règles de sécurité essentielles
Le port 18789 du gateway ne doit jamais être exposé sur Internet sans authentification. Si vous êtes sur un VPS, maintenez-le derrière un VPN ou un tunnel SSH.
- Commencez restrictif, élargissez progressivement. Il est toujours plus facile d'ouvrir des permissions que de les refermer.
- Sauvegardez
~/.openclaw/openclaw.jsonavant toute modification de sécurité. - Pour les modèles moins fiables (petits modèles locaux, fournisseurs expérimentaux), restreignez les outils accessibles.
Vérification : est-ce que ça tourne ?
Une fois l'installation terminée, trois commandes essentielles à connaître :
# Statut du daemon
openclaw gateway status
# Diagnostic complet (vérifie la config, les dépendances, les canaux)
openclaw doctor
# Logs en temps réel
openclaw logs --follow
Vous pouvez également ouvrir le dashboard web :
openclaw dashboard
Ou directement dans le navigateur : http://127.0.0.1:18789/
Le dashboard affiche les sessions actives, les canaux connectés, la consommation de tokens et les crons planifiés. C'est aussi l'endroit où vous constaterez que votre agent aura souvent été plus productif que vous dans la journée.
Guide du power user
L'installation de base est un bon point de départ. Mais OpenClaw révèle toute sa puissance lorsqu'il est configuré avec intention. Point essentiel avant d'entrer dans le détail : tout ce qui suit — la hiérarchie des modèles, les crons, la mémoire, les canaux — se configure en parlant à votre agent. Pas en éditant des fichiers JSON manuellement, pas en cherchant la bonne syntaxe dans la documentation. Vous décrivez ce que vous souhaitez en français, l'agent s'en charge. Les sections qui suivent vous expliquent les concepts pour savoir quoi demander.
Quelques exemples concrets
Voici le type de messages que j'envoie à mon agent sur Discord et ce qu'il exécute en retour :
- « Configure un fallback sur LM Studio avec Qwen si Anthropic est indisponible » → L'agent édite la configuration du gateway, ajoute le fournisseur LM Studio, télécharge le modèle, définit la chaîne de fallback et redémarre le daemon.
- « Mets en place une veille tech tous les matins à 9h, envoie le résultat sur #veille-tech » → Il crée le cron job, rédige le script de collecte RSS, configure le scoring, teste une première exécution et vous envoie le premier briefing pour validation.
- « Mon agent vocal ne fonctionne plus depuis la mise à jour » → Il lit les logs, identifie l'erreur, vérifie si c'est un bug connu, applique le correctif et confirme que tout fonctionne à nouveau.
- « Ajoute dans ma configuration que je veux des réponses courtes et directes » → Il met à jour SOUL.md avec vos préférences. Dès la session suivante, le ton change.
L'architecture cerveau/muscles en pratique
Lorsque vous demandez à OpenClaw de « chercher les dernières actualités sur l'IA et de coder un script de veille », voici ce qui se passe en coulisses :
- L'orchestrateur (votre modèle principal) reçoit la demande
- Il lance une recherche Perplexity en parallèle
- Il crée un sous-agent Sonnet pour écrire le script Python
- Pendant que les deux travaillent, il reste disponible pour vos autres demandes
- Il récupère les résultats, les synthétise et vous répond de manière cohérente
L'ensemble prend 10 à 30 secondes selon la complexité. Vous ne gérez rien : l'orchestrateur décide seul quand déléguer et à qui. Voici quelques configurations types selon le budget :
| Profil | Orchestrateur | Sous-agents | Fallback |
|---|---|---|---|
| Budget illimité (Claude Max) | Opus 4.6 | Sonnet 4.6, Haiku 4.5 | Sonar Pro (Perplexity) |
| Budget modéré (API payante) | Sonnet 4.6 | Gemini 3 Flash | Perplexity gratuit |
| Budget zéro | Gemini 3 Flash (quota gratuit) | Llama 4 Scout via Ollama | Perplexity gratuit |
| Tout local (air-gapped) | Qwen 3.5 35B ou Llama 4 Maverick via Ollama | Modèles plus légers | Aucun (tout en local) |
| Le fallback local est particulièrement utile : si Anthropic est indisponible, OpenClaw bascule automatiquement sur le modèle local configuré. | |||
Le système mémoire : la fonctionnalité la plus sous-estimée
L'agent démarre « à blanc » à chaque nouvelle session — il ne se souvient pas des échanges précédents. Mais le workspace, lui, persiste. Et OpenClaw injecte automatiquement les fichiers de ce workspace au début de chaque session.
- SOUL.md
- La personnalité de votre agent : son ton, ses limites, sa façon de répondre. Exemple : « Sois direct, pas de formulations marketing, humour sobre bienvenu. »
- USER.md
- Qui vous êtes : vos préférences, vos projets en cours, votre contexte professionnel. Plus c'est détaillé, plus les réponses sont pertinentes.
- AGENTS.md
- Le règlement intérieur : les règles non négociables, les workflows, les conventions. Exemple : « Ne jamais envoyer un e-mail sans validation explicite. »
- IDENTITY.md
- Le nom et la tonalité de l'agent. Un agent qui a un nom répond différemment d'un « assistant IA » anonyme.
- TOOLS.md
- Des notes sur vos outils locaux : chemins de scripts, credentials, commandes spécifiques à votre configuration.
- MEMORY.md
- La mémoire long terme curatée. L'agent peut la lire et la mettre à jour avec ce qui mérite d'être retenu entre les sessions.
- HEARTBEAT.md
- Une checklist pour les vérifications périodiques automatiques.
Conseils pour bien démarrer avec la mémoire :
Commencez par USER.md et SOUL.md. Ce sont les deux fichiers qui transforment un agent générique en votre agent. Le reste viendra naturellement.
Posez des règles fermes dès le premier jour. Dans AGENTS.md, définissez vos limites : toujours vérifier git status avant de commit, ne jamais envoyer un e-mail sans accord explicite, préférer la corbeille à rm…
Boostez la mémoire. Demandez à votre agent d'installer QMD, un moteur de recherche local combinant mots-clés (BM25), vecteurs sémantiques et reranking. Un seul message suffit : « installe QMD pour la mémoire, active l'indexation des sessions, passe les prompts de compaction en français, et active le hybrid search avec MMR et temporal decay. »
Pourquoi Discord est le canal idéal
Telegram est plus simple à configurer. WhatsApp est déjà présent sur votre téléphone. Mais Discord est objectivement le meilleur canal pour un usage sérieux. Sa structure en serveurs et canaux permet de créer une organisation par projet, avec des contextes isolés :
Serveur "Mon Agent"
├── 🧠 Général
│ ├── #daily → interactions quotidiennes
│ └── #chat → conversation libre
├── 📰 Veille
│ ├── #veille-tech → briefings automatiques
│ └── #veille-ia → actualités IA
├── 🗒️ Projets
│ ├── #projet-a → suivi projet A
│ └── #projet-b → suivi projet B
├── 💻 Dev
│ ├── #coding → tâches de développement
│ └── #logs → monitoring, erreurs
└── ⚙️ Config
└── #memory → mises à jour de contexte
L'avantage technique : chaque canal Discord est une session isolée avec son propre contexte. Dans #coding, l'agent est en mode développement. Dans #daily, il est en mode assistant généraliste. Pas de mélange de contextes.
Autres avantages : slash commands natifs, réactions emoji pour les confirmations rapides, threads pour isoler des sous-conversations, historique persistant, notifications push sur mobile (iOS et Android), gratuité totale.
| Canal | Facilité | Fiabilité | Organisation | Idéal pour |
|---|---|---|---|---|
| Telegram | ★★★★★ | ★★★★★ | ★★★☆☆ | Démarrer rapidement |
| ★★★★★ | ★★★☆☆ | ★★☆☆☆ | Usage mobile ponctuel | |
| Discord | ★★★★☆ | ★★★★★ | ★★★★★ | Usage avancé, multi-projets |
| Signal | ★★☆☆☆ | ★★★★☆ | ★★☆☆☆ | Confidentialité maximale |
| Slack | ★★★★☆ | ★★★★★ | ★★★★☆ | Contexte professionnel ou d'équipe |
| iMessage | ★★★★☆ | ★★★★☆ | ★★☆☆☆ | Utilisateurs Apple uniquement |
| WhatsApp utilise le protocole non officiel Baileys — Meta peut théoriquement suspendre des comptes en cas d'usage intensif. Non recommandé pour une utilisation 24/7. | ||||
Les crons et heartbeats : automatiser sans intervenir
Deux mécanismes permettent d'automatiser des tâches de manière fiable :
Les crons sont des tâches planifiées gérées par le scheduler intégré au gateway. Ils persistent sur disque (~/.openclaw/cron/) et survivent aux redémarrages.
# Rappel ponctuel dans 20 minutes
openclaw cron add \
--name "Rappel réunion" \
--at "20m" \
--session main \
--system-event "Rappel : préparer la réunion de 15h" \
--wake now \
--delete-after-run
# Veille tech tous les matins à 9h
openclaw cron add \
--name "Veille tech" \
--cron "0 9 * * *" \
--tz "Europe/Paris" \
--session isolated \
--message "Lance la veille tech et envoie le résultat." \
--announce \
--channel discord
# Lister les crons actifs
openclaw cron list
# Voir l'historique d'exécution
openclaw cron runs --id <job-id>
Les heartbeats sont des vérifications périodiques automatiques. Par défaut, toutes les 30 minutes, l'agent consulte votre HEARTBEAT.md et agit si quelque chose requiert son attention. Un exemple de HEARTBEAT.md :
- Vérifier les e-mails urgents non lus
- Rappeler les événements calendrier dans les 2 heures
- Signaler si un build CI est cassé depuis plus de 30 min
- Si rien à signaler : silence
Attention à la consommation de tokens : chaque heartbeat, chaque cron et chaque sous-agent consomme des tokens. Un heartbeat toutes les 30 minutes avec un modèle premium représente une centaine de requêtes par jour. Commencez avec peu d'automatisations, surveillez votre consommation via le dashboard, et montez progressivement. Préférez les modèles légers (Haiku, Gemini Flash) pour les tâches récurrentes.
Les messages vocaux : parler plutôt que taper
OpenClaw prend en charge nativement les messages vocaux. Sur Discord comme sur Telegram, envoyez un vocal : l'agent le transcrit automatiquement et traite votre demande comme un message texte ordinaire. Même accès aux outils, même mémoire, même contexte.
Pour configurer les réponses vocales avec Edge TTS (gratuit, aucune clé API) :
openclaw config set messages.tts.auto '"always"' --json
openclaw config set messages.tts.provider '"edge"' --json
openclaw config set messages.tts.edge.voice '"fr-FR-VivienneMultilingualNeural"' --json
Le mode always répond systématiquement en vocal. Si vous préférez que l'agent ne réponde en vocal que lorsque vous lui envoyez un vocal, utilisez inbound à la place. Il ne s'agit pas de conversation en temps réel, mais de push-to-talk asynchrone : vous envoyez, l'agent répond quelques secondes plus tard. Moins spectaculaire qu'un agent vocal dédié, mais bien plus pratique au quotidien. Vous pouvez aussi simplement demander : « active les réponses vocales en français. »
Définir qui vous êtes — et qui est votre agent
C'est l'aspect que la majorité des utilisateurs négligent, et c'est pourtant ce qui fait la différence entre un agent générique et un agent vraiment personnalisé.
Remplissez USER.md avec soin : vos préférences de communication, vos projets en cours, votre contexte professionnel, vos contraintes, vos outils habituels. Plus c'est détaillé, plus les réponses sont adaptées à votre situation réelle. Donnez une identité à votre agent via SOUL.md : définissez son ton, ses limites, ses valeurs. Ce fichier est ce qui transforme un LLM générique en un assistant qui correspond à votre façon de travailler. Utilisez AGENTS.md comme règlement intérieur : les règles non négociables, les conventions de nommage, les workflows récurrents. C'est votre manuel d'opérations, relu par l'agent à chaque session.
Le brain dump et le reverse prompting
Voici le conseil le plus important de ce guide : renseignez USER.md de manière exhaustive. Un agent IA, c'est comme un assistant brillant qui arrive le premier jour sans rien connaître de vous. Si vous lui communiquez uniquement votre prénom et votre métier, ses réponses seront génériques — correctes, mais sans valeur ajoutée réelle. Si vous lui expliquez votre contexte de travail, vos projets, vos contraintes horaires, vos préférences de formatage et vos objectifs à long terme, il devient véritablement utile.
Voici ce qui mérite d'être inclus dans USER.md :
- Votre contexte professionnel : poste, entreprise, responsabilités, outils du quotidien
- Vos projets en cours : nom, état d'avancement, stack technique, objectifs
- Vos préférences de communication : langue, ton, niveau de détail attendu, formatage
- Vos contraintes : horaires, budget, niveau de compétences techniques, deadlines
- Vos centres d'intérêt : ce que vous suivez, vos sources d'information préférées
- Vos objectifs : court terme, long terme, professionnels — tout ce qui aide l'agent à prioriser
L'astuce du reverse prompting
Si vous ne savez pas par où commencer, cette technique proposée par Alex Finn est particulièrement efficace. Procédez en deux étapes :
Étape 1 — Le brain dump brut. Ouvrez un chat avec votre agent et exprimez librement votre contexte : qui vous êtes, ce que vous faites, vos projets, vos ambitions. Sans structure particulière. Puis envoyez ce message : « D'après ce que tu sais de moi et de mes objectifs, quelles informations supplémentaires est-ce que je peux te donner pour que tu puisses m'aider à atteindre mes objectifs plus vite et me décharger au maximum ? » L'agent vous posera des questions ciblées auxquelles vous n'auriez pas pensé seul.
Étape 2 — La mise en action. Une fois vos réponses apportées : « Qu'est-ce que tu peux faire pour moi maintenant pour qu'on avance vers nos objectifs ? » Vous découvrirez des usages auxquels vous n'aviez pas pensé. Demandez-lui ensuite de synthétiser tout cela dans un USER.md structuré.
Ce qu'il ne faut pas lui communiquer
Les fichiers de mémoire d'OpenClaw sont stockés en clair sur votre machine — ce sont des fichiers Markdown, pas un coffre-fort chiffré. Et chaque message envoyé à l'agent transite par l'API du fournisseur pour être traité par le modèle. La règle de base : ne mettez dans le workspace que ce que vous accepteriez de voir exposé.
À ne jamais stocker dans vos fichiers de mémoire :
- Numéros de carte bancaire, codes PIN, mots de passe en clair
- Numéros de sécurité sociale, informations d'identité
- Secrets d'entreprise, documents confidentiels couverts par un NDA
- Données médicales sensibles
- Informations bancaires détaillées (RIB, IBAN, relevés)
Les clés API et tokens techniques vont dans ~/.openclaw/.env — un fichier séparé du workspace, non injecté dans le contexte du modèle, et qui ne doit jamais être commité dans un dépôt.
Si vous sauvegardez votre workspace dans un dépôt Git (ce que je recommande), assurez-vous qu'il soit privé. Un USER.md bien rempli constitue un profil complet de votre vie professionnelle et personnelle.
Quand ça casse — et ça arrivera
Soyons directs : OpenClaw est un outil aussi puissant que jeune. Le projet évolue rapidement — parfois trop. Une mise à jour peut casser un canal, un modèle peut produire une commande erronée, un cron mal configuré peut générer des centaines de notifications au milieu de la nuit. Ces situations m'ont toutes concerné.
Travaillez avec un plan, pas à l'instinct
Avant de demander à votre agent de « refactoriser tout le projet » ou de « configurer le monitoring complet », prenez cinq minutes pour définir l'objectif. Demandez-lui de proposer un plan d'action avant d'exécuter quoi que ce soit. Un agent avec un plan produit un travail propre. Un agent sans plan peut générer du chaos.
Concrètement : « Propose-moi un plan pour mettre en place la veille tech, étape par étape, sans rien exécuter pour l'instant. » C'est toujours plus sûr que « Lance la veille tech. »
Demandez-lui de consulter la documentation
OpenClaw intègre sa propre documentation en local (/docs/). L'agent peut la lire. Si vous bloquez sur une configuration, demandez-lui : « va lire la doc officielle sur les crons » ou « cherche sur le Discord communautaire si d'autres ont rencontré ce problème. » Il dispose d'un accès au web, aux documentations officielles et aux forums.
Le Discord communautaire OpenClaw est une ressource précieuse. Les retours d'utilisateurs y sont souvent plus à jour que la documentation officielle.
Les commandes de dépannage essentielles
# L'agent ne répond plus ? Redémarrez le daemon
openclaw gateway restart
# Diagnostic complet
openclaw doctor
# Voir ce qui se passe en temps réel
openclaw logs --follow
# Un canal s'est déconnecté ?
openclaw channels status
openclaw channels login --channel discord
# Un cron génère trop de notifications ?
openclaw cron list
openclaw cron remove <job-id>
# En dernier recours : tout arrêter
openclaw gateway stop
Les erreurs classiques à éviter
- Accorder trop d'autonomie trop tôt : commencez en mode « propose, n'exécute pas ». Augmentez les permissions progressivement.
- Utiliser l'agent pour des tâches triviales : votre agent peut coder une application complexe pendant que vous dormez. Calibrez vos demandes à ses capacités réelles.
- Négliger les fichiers de mémoire : un USER.md vide produit un agent générique. Dix minutes d'investissement changent radicalement le résultat.
- Omettre de sauvegarder la configuration : effectuez un backup de
~/.openclaw/openclaw.jsonavant toute modification. Une commande maladroite peut casser votre setup. - Lancer des tâches lourdes sans les tester : un cron qui échoue en boucle consomme des tokens inutilement. Testez manuellement, puis automatisez.
Le conseil à retenir : dès que votre agent est opérationnel, envoyez-lui l'URL de cet article et demandez-lui de tout mettre en place après vous avoir posé quelques questions. Il adaptera chaque recommandation à votre configuration, vos besoins et votre budget. En vingt minutes, il aura réalisé ce que vous mettriez trois heures à configurer manuellement.
Conclusion
OpenClaw n'est pas un outil parfait. L'installation demande un peu de temps, le système de fichiers de mémoire a une courbe d'apprentissage, et certains canaux (Signal, iMessage) peuvent être délicats à configurer. Mais c'est aujourd'hui l'outil le plus proche d'un assistant IA qui fonctionne réellement sur votre machine, avec vos outils et selon vos règles. Pas un chatbot qui perd le fil à chaque nouvelle session. Vos fichiers, votre mémoire et votre configuration restent sur votre machine. Vous conservez le contrôle.
Le modèle est simple : votre machine, votre agent, vos règles. Vous choisissez le modèle LLM, le canal de messagerie, le niveau d'autonomie. Et une fois configuré correctement — avec des fichiers de mémoire bien renseignés, une architecture cerveau/muscles adaptée et des automatisations réfléchies — le résultat est réellement impressionnant.
Ce n'est pas une révolution de plus. C'est le moment où l'ordinateur cesse d'être un outil passif et commence à travailler avec vous.