OpenClaw : installation, modèles, sécurité et coûts

OpenClaw est un assistant IA auto-hébergé qui relie un modèle de langage, des outils et des interfaces de conversation. Pour l’utiliser, vous installez son Gateway, configurez un accès au modèle, puis accordez les permissions nécessaires à vos tâches. Le logiciel ne supprime ni les coûts des services externes ni la responsabilité de contrôler les actions exécutées.

Comprendre les briques avant d’installer

Le Gateway est le point de fonctionnement de l’installation. Il reçoit les messages et fait le lien avec les sessions, les modèles et les capacités configurées. Le modèle produit les réponses et choisit des actions ; les outils effectuent les opérations autorisées.

Cette séparation aide à diagnostiquer les erreurs. Un tableau de bord accessible ne prouve pas que le fournisseur de modèle accepte vos identifiants. Une réponse correcte dans le navigateur ne prouve pas que votre messagerie autorise le bon expéditeur. Enfin, un modèle peut décrire une opération sans disposer de l’outil permettant de l’exécuter.

OpenClaw appartient à la famille des assistants personnels présentés dans notre annuaire des agents IA. Son intérêt dépend surtout de votre besoin de relier conversations et actions. Pour rédiger occasionnellement un texte, maintenir un service et ses permissions peut représenter une charge inutile.

Définissez d’abord une tâche vérifiable : résumer un dossier de documents fictifs, préparer un brouillon ou produire une liste de fichiers. Écartez les paiements, les suppressions et les envois réels du premier essai. Vous pourrez ainsi distinguer la qualité de la réponse du bon fonctionnement des connexions.

Le présent guide couvre l’exploitation dans la durée. L’article Installer OpenClaw pas à pas complète ce cadre par un parcours centré sur l’installation selon le système.

Prérequis et choix de la machine

La documentation de démarrage officielle, consultée le 24 octobre 2026, indique Node.js 24.16 ou ultérieur dans cette branche, ou 26.1 ou ultérieur, et recommande Node.js 26. Elle prévoit un accès compatible au modèle ; l’assistant de configuration peut aussi détecter certains accès déjà présents sur la machine.

Avant de commencer, préparez :

une machine sur laquelle vous pouvez installer des logiciels ;
un compte système dédié si l’agent doit travailler régulièrement ;
un dossier de travail contenant uniquement les données nécessaires ;
un accès au modèle et un moyen d’en surveiller la consommation ;
une sauvegarde des documents que vous autoriserez l’agent à modifier.

Critère	Ordinateur personnel	Serveur dédié
Disponibilité	Dépend de la veille et de l’arrêt	Peut rester accessible en permanence
Accès aux documents	Documents déjà présents, à cloisonner	Transfert ou synchronisation à organiser
Entretien	S’ajoute à l’entretien du poste	Système, accès distant et sauvegardes à gérer
Isolation	Exige de limiter les dossiers accessibles	Plus facile à organiser sur un hôte séparé

Un serveur n’est pas automatiquement plus sûr. Un service exposé sans contrôle peut être plus risqué qu’une installation locale limitée. Choisissez selon la disponibilité nécessaire, votre capacité d’administration et les données concernées, sans dimensionner la machine pour un modèle local si vous utiliserez une API distante.

1. Installer et ouvrir une première conversation

Les commandes suivantes reprennent le parcours de démarrage officiel cité plus haut. Sur macOS ou Linux, l’installation proposée est :

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

Sur Windows, le parcours PowerShell documenté est :

iwr -useb https://openclaw.ai/install.ps1 | iex

Ces commandes téléchargent et exécutent un script. Vérifiez le domaine et examinez le script si votre politique informatique l’exige. N’accordez pas des droits administrateur à l’agent simplement parce qu’une dépendance en a eu besoin pendant l’installation.

L’installateur lance la configuration guidée. Commencez avec le parcours simple si les accès détectés correspondent au compte souhaité ; choisissez la configuration personnalisée pour examiner les options. À ce stade, laissez les connexions supplémentaires de côté.

Si le Gateway fonctionne au premier plan, arrêtez-le avec le raccourci indiqué par le terminal avant d’installer son service :

openclaw gateway install

Vérifiez ensuite le service et ouvrez l’interface :

openclaw gateway status
openclaw dashboard

Envoyez une demande sans effet extérieur, par exemple une reformulation de texte. Une réponse confirme le premier trajet entre interface et modèle. Ne testez pas encore une messagerie et une skill simultanément : si le résultat échoue, vous ne saurez pas quelle couche corriger.

Conservez les indications utiles de l’installation, mais retirez clés, jetons et liens d’accès avant de partager une capture ou un compte rendu.

2. Configurer le dossier, les instructions et les accès

La référence de configuration indique que le fichier habituel est ~/.openclaw/openclaw.json, au format JSON5. Le schéma est strict : des clés inconnues ou des valeurs invalides peuvent empêcher le démarrage. Préférez d’abord l’assistant ou les formulaires de l’interface aux exemples copiés depuis des discussions anciennes.

Pour reprendre les réglages :

openclaw configure

Le dossier de travail doit correspondre à un périmètre explicite. Évitez de donner accès à tout votre répertoire personnel pour traiter quelques documents. Placez les fichiers d’essai dans un espace distinct et vérifiez les permissions du compte qui exécute le service.

Vos instructions devraient préciser le résultat attendu, les sources autorisées, les fichiers modifiables et les opérations exigeant une validation. Par exemple : préparer des brouillons, conserver les originaux et demander confirmation avant toute transmission. Ces consignes orientent le modèle ; les restrictions techniques doivent empêcher les opérations interdites.

Distinguez également instructions durables et données de tâche. Un document reçu peut contenir une phrase impérative sans constituer une autorisation. L’agent doit traiter son contenu comme une source à analyser, pas comme une modification de vos règles.

Avant chaque changement significatif, sauvegardez la configuration et notez son objectif. Modifiez un ensemble cohérent de réglages, vérifiez le démarrage et répétez votre tâche témoin. Cette discipline simplifie le retour à un état connu.

3. Choisir le modèle et vérifier l’authentification

Le choix porte sur un couple fournisseur-modèle, un accès autorisé et des capacités adaptées. La documentation des modèles distingue notamment le modèle principal, les modèles de repli et les profils d’authentification. Elle précise que le mécanisme d’exécution et le mode de facturation sont des questions distinctes.

Commencez par examiner ce que votre installation connaît :

openclaw models status
openclaw models list

Utilisez les identifiants fournis par le catalogue et la documentation du fournisseur. Un nom commercial ressemblant à un autre ne garantit ni compatibilité ni droits d’accès.

Critère	Modèle via API distante	Modèle exécuté localement
Dépense principale	Consommation et services associés	Matériel, énergie et administration
Circulation des données	Contenu transmis au fournisseur	À vérifier sur toute la chaîne d’outils
Capacité disponible	Dépend du catalogue et des quotas	Dépend du matériel et du modèle
Diagnostic	Identifiants, limites, disponibilité	Chargement, mémoire, serveur d’inférence

Une plateforme comme OpenRouter constitue un intermédiaire supplémentaire à prendre en compte dans le circuit des données et des coûts. Un logiciel comme Ollama répond à un autre besoin : servir des modèles sur une machine que vous administrez. Dans les deux cas, vérifiez le parcours d’intégration officiellement pris en charge avant de configurer l’endpoint.

Évaluez le modèle sur vos tâches : respect des limites, choix des outils, traitement des erreurs et qualité du résultat. Un tarif bas par réponse ne compense pas des tentatives répétées ou des corrections manuelles nombreuses. Contrôlez aussi les replis : ils peuvent changer le fournisseur destinataire et le coût effectif.

4. Ajouter des skills sans élargir les droits par défaut

Une skill décrit comment et quand utiliser des capacités. Selon la documentation officielle des skills, elle repose sur un dossier contenant un fichier SKILL.md, avec des métadonnées YAML et des instructions Markdown. Son chargement peut dépendre de la configuration, de l’environnement et des programmes disponibles.

Ne confondez pas trois éléments :

la skill explique une méthode ;
l’outil réalise une opération ;
les permissions déterminent ce que l’opération peut atteindre.

Une skill peut donc être visible sans être utilisable, ou proposer une procédure incompatible avec vos restrictions. Inversement, des instructions courtes peuvent appeler un programme très puissant.

Commencez par les capacités déjà disponibles. Si vous ajoutez une skill externe, examinez son origine, ses instructions, ses scripts et ses dépendances. Recherchez les téléchargements exécutables, les accès aux secrets, les transmissions réseau et les changements de permissions.

La portée compte aussi. La documentation donne priorité aux skills du dossier de travail sur plusieurs autres sources, notamment les skills intégrées. Une copie locale peut donc modifier le comportement attendu. Vérifiez les collisions de noms et conservez une trace des modifications.

Testez chaque ajout avec des données fictives, dans un périmètre limité. Une analyse automatisée ou une signature ne prouve pas que la procédure correspond à votre usage. Pour préparer une compétence réutilisable, le guide des skills d’agents détaille la séparation entre instructions, ressources et vérification.

5. Connecter une messagerie et contrôler les expéditeurs

Une messagerie ajoute une entrée distante vers votre agent. Elle ne doit être connectée qu’après validation du modèle et des outils depuis l’interface locale. Sinon, une erreur de canal peut masquer une panne d’authentification ou une configuration invalide.

La documentation des canaux présente Telegram comme le parcours initial le plus simple, avec un jeton de bot. WhatsApp utilise un appairage par QR et conserve davantage d’état sur disque. Slack et Discord font également partie des canaux documentés ; leurs permissions et comportements doivent être examinés séparément.

Pour Telegram, suivez cet ordre :

Créez le bot selon la procédure officielle du canal.
Enregistrez son jeton dans le parcours de configuration prévu.
Vérifiez l’identité autorisée à converser avec l’agent.
Envoyez une demande sans action extérieure en conversation privée.
Testez ensuite les restrictions avant d’ajouter un groupe.

Ne publiez jamais le jeton dans une conversation d’assistance. Si vous le divulguez, révoquez-le auprès du service concerné.

Dans les groupes, distinguez le droit de voir un message, de déclencher une réponse et d’autoriser une action. Une mention du bot peut limiter les interruptions ; elle ne remplace pas une liste d’utilisateurs autorisés.

Vérifiez enfin les destinataires possibles des outils de messagerie. Lire une conversation et envoyer un message sont deux permissions différentes. Avant un usage professionnel, testez explicitement qu’un utilisateur ne peut pas faire transmettre des données vers un autre espace sans votre accord.

Sécurité : contenir les conséquences d’une erreur

La documentation de sécurité d’OpenClaw décrit une frontière de confiance commune au Gateway. Pour des utilisateurs qui ne se font pas confiance, elle recommande des installations et identifiants séparés, idéalement avec des comptes système ou des hôtes distincts. Elle signale aussi que les paramètres réseau diffèrent entre installation classique et conteneurs.

Lancez l’audit documenté :

openclaw security audit

Lisez les résultats et vérifiez les conséquences des corrections proposées. Un audit de configuration ne garantit pas qu’une tâche métier soit raisonnable ni qu’un document externe soit fiable.

Le risque d’injection de prompt apparaît lorsqu’un contenu consulté tente de détourner l’agent. Réduisez les conséquences possibles : accès limité aux dossiers, comptes dédiés, outils inutiles désactivés et validation avant envoi, suppression ou engagement financier.

Un environnement isolé ne protège que ce qu’il sépare effectivement. Examinez les dossiers montés, le réseau, les secrets disponibles et les profils de navigateur accessibles. Un navigateur déjà connecté peut donner accès à des services sensibles même sans clé API explicitement fournie à l’agent.

Appliquez le moindre privilège aux outils et aux comptes externes. Les instructions écrites doivent compléter ces restrictions, pas les remplacer.

Le guide pour sécuriser un agent IA propose un cadre plus large pour les secrets, les approbations et la journalisation. Réévaluez ce cadre après chaque nouveau canal ou outil.

Coûts : mesurer la tâche complète

L’absence de prix d’abonnement au logiciel ne signifie pas absence de dépense. Le site officiel d’OpenClaw, consulté le 24 octobre 2026, présente le projet sans abonnement ni offre hébergée. Votre installation peut néanmoins consommer des API facturées et nécessiter un hébergement.

Séparez votre budget en postes : modèle principal, éventuels replis, recherche ou traitement de médias, machine, stockage et temps de maintenance. Un appel d’outil peut déclencher sa propre facture, indépendamment des tokens du modèle.

Pour estimer la consommation du modèle, additionnez les entrées et sorties de tous les appels. L’historique, les instructions et les résultats d’outils peuvent être renvoyés au fil de la tâche. Une courte réponse finale peut donc correspondre à beaucoup de travail intermédiaire.

Le calculateur de prix LLM aide à construire une estimation ; confrontez-la ensuite aux relevés du fournisseur. Vérifiez séparément les catégories tarifaires particulières, notamment le cache ou les traitements de médias, lorsqu’elles s’appliquent.

Mettez une limite de dépense chez le fournisseur lorsqu’elle est disponible. Une alerte informe ; elle n’arrête pas nécessairement la consommation. Mesurez aussi le coût par tâche acceptée, en incluant reprises et corrections humaines.

Pour réduire la facture, commencez par limiter les documents transmis, les outils disponibles et les tâches récurrentes inutiles. Changez ensuite de modèle en répétant les mêmes essais, afin de vérifier que l’économie ne dégrade pas le résultat attendu.

Problèmes fréquents

Le tableau de bord s’ouvre, mais aucune réponse n’arrive. Vérifiez l’état du modèle et ses identifiants. Distinguez un refus d’accès, un quota atteint et un modèle indisponible avant de modifier le Gateway.

Le service refuse de démarrer après une modification. La validation stricte peut rejeter une ancienne clé ou une valeur incorrecte. Consultez le diagnostic :

openclaw doctor

Comparez l’erreur avec votre dernière modification. Évitez d’empiler d’autres changements avant d’avoir retrouvé un état fonctionnel.

Une skill est présente, mais ne fonctionne pas. Vérifiez sa portée, ses dépendances et les restrictions de l’environnement. Ne résolvez pas une dépendance manquante en ouvrant tous les accès.

Le bot ne répond pas dans la messagerie. Confirmez d’abord que la conversation locale fonctionne. Examinez ensuite l’identité de l’expéditeur, l’appairage, les autorisations du canal et les règles de groupe.

La consommation continue hors des échanges attendus. Recherchez les tâches récurrentes et les appels supplémentaires dans les relevés et journaux disponibles. Suspendez les automatismes concernés pendant le diagnostic.

Une connexion sensible semble compromise. Arrêtez les accès concernés, révoquez les identifiants exposés et conservez les traces utiles sans les publier. Restaurer un fichier de configuration ne révoque pas un jeton volé.

Checklist avant un usage régulier

Une installation prête doit réussir une tâche représentative et refuser une demande hors périmètre. Conservez ces essais pour les rejouer après une mise à jour ou un changement de modèle.

Pages liées

Questions fréquentes

Faut-il laisser son ordinateur allumé pour utiliser OpenClaw ?

La machine qui exécute le Gateway doit rester disponible pour traiter les messages. Installer un service permet de fonctionner sans terminal ouvert, mais ne maintient pas un ordinateur éteint ou en veille. Pour une disponibilité continue, prévoyez un hôte adapté et son entretien.

Peut-on utiliser OpenClaw sans connecter de messagerie ?

Oui, le tableau de bord permet de commencer par une conversation dans le navigateur. C'est un parcours utile pour vérifier séparément le modèle et les outils avant d'ajouter un canal externe.

OpenClaw fonctionne-t-il avec un abonnement à un assistant IA ?

Cela dépend du fournisseur, du mécanisme d'authentification et du parcours officiellement pris en charge. Un abonnement à une interface de discussion ne donne pas automatiquement des crédits API. Vérifiez le compte effectivement utilisé et ses conditions avant de lancer des tâches récurrentes.

Une skill peut-elle fonctionner sans logiciel supplémentaire ?

Certaines skills se limitent à des instructions, d'autres supposent un programme installé, une clé ou un service accessible. La présence du fichier ne suffit donc pas à garantir son fonctionnement. Il faut vérifier ses dépendances et son environnement d'exécution.

Peut-on partager une installation entre plusieurs clients ?

Ne traitez pas une installation commune comme une séparation de sécurité entre clients qui ne se font pas confiance. La documentation recommande de séparer les Gateway et les identifiants lorsque les frontières de confiance diffèrent. Cette séparation doit aussi couvrir les comptes système et les données accessibles.

OpenClaw, guide de référence : installation, configuration, modèles, skills, messageries, sécurité et coûts