OpenClaw agent IA : installer, sécuriser, superviser

OpenClaw agent IA open source : installation d’après le README, risques de droits et d’isolation, export OpenTelemetry, audit et coûts à superviser.
OpenClaw agent IA : installer, sécuriser, superviser

OpenClaw agent IA : c’est le nom d’un assistant open source que l’on installe sur son propre ordinateur et qui répond dans les messageries déjà utilisées (WhatsApp, Telegram, Slack, Discord, Teams, iMessage et plus de vingt autres, selon le README). Le dépôt openclaw/openclaw affichait environ 392 000 étoiles à la mi-octobre 2026, ce qui en fait l’un des projets les plus suivis de GitHub. Sa description tient en une ligne : « The AI that really does things. Any OS. Any Platform. »

« Qui agit » est le point qui nous concerne. Un agent qui lit des fichiers, lance des commandes et écrit dans des messageries est un service d’exploitation comme un autre : il consomme des tokens, il échoue, il a des droits. Cet article présente le projet avec des faits datés, résume l’installation d’après le README, puis détaille ce qui intéresse un SRE : les traces OpenTelemetry, le journal d’audit, le suivi des coûts et les réglages de sécurité à poser avant toute exposition.

Ce qui suit s’appuie sur le README et la documentation officielle du projet. span.observer n’a pas installé le logiciel : les images viennent de la documentation du projet et de ses exemples, pas d’un essai.

OpenClaw agent IA : ce que dit le dépôt

  • Licence : MIT, avec la mention « Copyright (c) 2026 OpenClaw Foundation » dans le fichier LICENSE.
  • Gouvernance : le README indique que le projet est piloté par l’OpenClaw Foundation, une organisation 501(c)(3), qui emploie l’équipe principale et signe les versions. Il précise qu’il n’y a ni offre payante, ni service hébergé, ni jeton, et qu’OpenAI est un donateur, pas un propriétaire.
  • Technologie : projet Node.js et TypeScript (espace de travail pnpm), Node 24.16 ou plus récent pour l’installation par npm.
  • Dernière version : v2026.10.4, publiée le 16 octobre 2026 selon la page des versions. Le rythme de publication est très rapide.
  • Architecture : un Gateway local sert de plan de contrôle (sessions, outils, événements, connexions aux messageries). L’interface web (Control UI), la ligne de commande et le TUI s’y connectent, ainsi que des applications compagnons pour macOS, iOS, Android, Windows et Linux.
  • Modèles : Claude, Codex et des modèles locaux sont des plugins interchangeables, selon le README.

Le README donne une position sur la confidentialité : état, mémoire et identifiants restent sur la machine ; les prompts partent vers le fournisseur de modèles et les plateformes de chat que vous configurez ; par défaut, OpenClaw n’émet qu’un contrôle de version quotidien, et update.checkOnStart: false le désactive.

Installer OpenClaw étape par étape

Les commandes ci-dessous sont celles du README. Lisez le script avant de l’exécuter : un « curl | bash » donne la main à son contenu.

Étape 1 — Installer

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

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

# Si Node.js est déjà géré (Node 24.16+ ou 26.1+)
npm install -g openclaw@latest --allow-scripts=openclaw

Le README précise que l’option --allow-scripts=openclaw vaut pour npm 12 ou npm 11.16 et plus ; avec npm 11.15 et antérieur, il faut l’omettre.

Étape 2 — Faire l’intégration et vérifier

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

L’intégration vérifie l’accès au modèle, crée l’espace de travail et configure le Gateway ; openclaw dashboard ouvre la Control UI, où un message de test confirme que l’assistant répond.

Sécurité : un agent qui a des droits sur votre poste

Le README le dit sans détour : les messages entrants sont des entrées non fiables, et les outils s’exécutent sur l’hôte pour la session principale, sauf si vous configurez l’isolation (sandboxing). Les messageries directes appairent les expéditeurs inconnus par défaut (openclaw pairing approve <channel> <code>). La documentation de sécurité ajoute que, sur une installation hôte classique, le Gateway écoute sur la boucle locale, et que les images de conteneur exposent le port par défaut : il faut alors une authentification.

  • Lancez openclaw security audit (option --deep pour les contrôles du Gateway en cours d’exécution) : la documentation le décrit comme un audit des erreurs de configuration courantes.
  • Le modèle de confiance est « un opérateur par Gateway ». Pour des utilisateurs qui ne se font pas confiance, la documentation demande des Gateways, des identifiants et idéalement des comptes système séparés.
  • Isolez l’exécution : la documentation décrit OpenShell comme backend de sandbox géré, avec des pré-requis de version précis ; voir notre article sur NVIDIA OpenShell.
  • Gardez les secrets hors de la session : ni jeton personnel, ni clé de production sur l’hôte qui exécute l’agent.

Observer OpenClaw : OpenTelemetry, audit et coûts

Les garde-fous se mesurent (voir les garde-fous des agents en production) et le coût aussi (voir le coût d’un agent IA). OpenClaw fournit de quoi faire les deux sans code supplémentaire.

Traces, métriques et journaux OTLP

L’export OpenTelemetry passe par un plugin, diagnostics-otel (openclaw plugins install clawhub:@openclaw/diagnostics-otel). La documentation donne cette configuration de départ :

Extrait de la documentation OpenClaw : bloc de configuration diagnostics.otel avec endpoint http://otel-collector:4318, protocole http/protobuf, serviceName openclaw-gateway, traces, métriques et journaux activés, sampleRate 0.2
  • Seul le protocole http/protobuf est accepté ; gRPC est retiré. Les traces et métriques sont actives dès que diagnostics.otel.enabled est vrai ; les journaux restent désactivés tant que logs n’est pas explicitement à true.
  • Les métriques du catalogue incluent openclaw.tokens (compteur par canal, fournisseur, modèle et agent), openclaw.cost.usd (compteur par canal, fournisseur et modèle) et openclaw.run.duration_ms (histogramme). Les métriques standard gen_ai.client.token.usage et gen_ai.client.operation.duration gardent leur nom.
  • Les traces couvrent l’usage des modèles, les appels d’outils, l’exécution de commandes et les boucles d’outils. Le contenu brut (prompts, réponses, arguments d’outils) n’est pas exporté par défaut ; captureContent ne doit passer à true qu’après validation de la rétention côté collecteur.
  • Une exécution openclaw agent exec n’exporte aucune télémétrie ; passez par le Gateway ou openclaw agent --local pour obtenir des traces.

Le Collector et la destination (Dynatrace SaaS par OTLP, Grafana, Langfuse) se règlent comme pour n’importe quel service ; voir Langfuse et OpenLLMetry. Sur Dynatrace Managed, il n’y a pas de DQL : gardez le chemin Prometheus ou un backend open source.

Journal d’audit : qui a lancé quoi

Le Gateway tient un registre d’audit actif par défaut, limité aux métadonnées : identité, horodatage, nom d’outil, résultat normalisé, jamais les prompts, arguments ou résultats. Les enregistrements expirent après 30 jours et le registre est plafonné à 100 000 lignes ; la documentation précise que l’écriture est « best-effort » et non une archive de conformité.

Commandes openclaw audit tirées de la documentation : filtres par agent, statut, session, exécution, type tool_action ou message, avec sortie JSON

Comment vérifier que ça fonctionne

  • openclaw doctor et openclaw status --all montrent un état d’export expurgé pour chaque signal ; il n’affiche ni point de terminaison ni en-têtes.
  • Après un message de test, une trace apparaît dans le backend avec le nom de service que vous avez défini, et le compteur openclaw.tokens augmente.
  • openclaw audit --status failed liste les exécutions en échec ; openclaw gateway usage-cost --days 7 résume le coût des sept derniers jours à partir des journaux de session (la documentation avertit que les totaux peuvent être incomplets si le cache se rafraîchit).

Limites et points ouverts

  • Croissance très rapide. Un nombre d’étoiles mesure l’attention, pas la maturité ni la sûreté. Les versions portent une date (v2026.10.4) et les réglages changent : plusieurs pages de la documentation décrivent des clés « retirées » ou migrées par openclaw doctor --fix.
  • Modèle de confiance personnel. Le projet n’est pas conçu pour des utilisateurs hostiles les uns envers les autres au sein d’un même Gateway.
  • Extensions. Les skills et plugins de la place de marché ClawHub ajoutent du code et des droits : lisez leurs audits avant installation.
  • Fichiers de journaux. Les fichiers bruts contiennent les enregistrements sans masquage à la lecture directe ; ils sont en 0600, protégez-les comme les bases d’état.

Bonnes pratiques

  • Installez sur un compte dédié ou une machine dédiée, jamais sur le poste qui porte vos clés de production.
  • Activez le sandboxing avant de connecter une messagerie à plusieurs interlocuteurs.
  • Exportez traces et métriques vers un backend séparé de la machine de l’agent ; fixez sampleRate selon le volume.
  • Alertez sur openclaw.cost.usd et sur la durée des exécutions, et traitez une dérive comme un incident sans chercher de coupable.
  • Désactivez captureContent tant qu’aucune politique de rétention ne l’autorise.

Questions fréquentes

OpenClaw est-il gratuit ?

Le code est sous licence MIT et le README indique l’absence d’offre payante. Vous payez en revanche votre fournisseur de modèles, au token.

OpenClaw envoie-t-il des données à son éditeur ?

D’après le README, rien d’autre qu’un contrôle de version quotidien par défaut ; les statistiques d’usage anonymes sont optionnelles. Vos prompts vont au fournisseur de modèles et aux plateformes que vous configurez.

Peut-on l’exposer sur Internet ?

La documentation fournit un guide de pré-vérification avant toute exposition au-delà de la boucle locale. Suivez-le, activez l’authentification et l’isolation, et lancez openclaw security audit.

Conclusion

OpenClaw associe un grand écosystème de messageries à un Gateway local, et il livre ce que l’exploitation demande : export OpenTelemetry, métriques de coût, registre d’audit. Son succès ne dispense pas de le traiter comme un service privilégié : isolation, secrets, alertes de coût. Pour la suite de la série, voir Paperclip, qui orchestre des équipes d’agents dont OpenClaw peut faire partie.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle (docs.openclaw.ai).

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Selecto AI Windows : une barre d'actions sur le texte sélectionné

Selecto AI Windows : une barre d’actions sur le texte sélectionné

Next Post
Paperclip orchestration agents IA : installer et superviser

Paperclip orchestration agents IA : installer et superviser

Related Posts