Changer le thème

Optimisation des performances OpenClaw : de l'analyse des logs à 80 % d'économies — méthode pratique

Easton editorial illustration: modular AI application workbench

Le mois dernier, la facture Anthropic affichait 347 $ — j’étais sidéré. J’avais juste rédigé quelques articles et fait des revues de code avec OpenClaw. Pire encore : les réponses ralentissaient, parfois plus de 20 secondes d’attente.

J’ai fixé la facture un long moment. Puis j’ai ouvert les logs.

Ligne après ligne, le problème est apparu : chaque conversation embarquait tout l’historique. Après 10 tours, le contexte atteignait 150K tokens. C’est comme répéter toutes vos conversations passées à chaque message — pas étonnant que la facture explose.

Deux semaines de tests : reset de session, bascule de modèle, cache, limite de contexte. Résultat : de 347 $ à 68 $ par mois, de 23 s à 4 s de temps de réponse.

La surconsommation de tokens OpenClaw vient surtout d’une mauvaise utilisation. Cet article partage des méthodes pratiques, de l’analyse des logs aux stratégies d’optimisation — tout est copiable-collable.

Guide low-cost « élevage de crevettes » : ArkClaw démocratise les agents IA

OpenClaw (homard) est puissant mais la config rebute ? ByteDance Volcano Engine a lancé ArkClaw : sans serveur ni config de tokens, un agent 24h/24 qui contrôle le navigateur, exécute des scripts et gère le calendrier.

Le prix : 9,9 ¥/mois ; avec mon code ZLKUK54M (inscription ici), 8,9 ¥. Développeurs : Coding Plan Pro inclut l’offre gratuitement.

Les racines du problème de performance — pourquoi OpenClaw ralentit

Les 5 grands consommateurs de tokens

Vous pourriez penser que c’est juste une question de volume. En réalité, c’est plus complexe.

150K
tokens
Contexte cumulé après 10 tours de conversation

Consommateur 1 : contexte de conversation cumulé sans limite

OpenClaw conserve par défaut tout l’historique. Le premier tour : ~5K tokens ; au dixième : 150K. Chaque question renvoie tout le passé à l’API Claude. Comme répéter toutes vos conversations de la semaine et du mois à chaque échange — épuisant et coûteux.

J’ai testé : une simple demande « regarde si ce code a un problème », avec 100K tokens de contexte, facturée à 100K même pour une réponse de 200 mots.

Consommateur 2 : stockage illimité des sorties d’outils

OpenClaw lit des fichiers, consulte des logs, exécute des commandes. Chaque sortie d’outil est intégralement conservée dans le contexte. 500 lignes de log ? Elles restent en mémoire. Un fichier de config en plus ? Encore des centaines de lignes.

Une fois, j’ai fait analyser un log d’erreur de 10 Mo — ce fragment est resté dans le contexte, facturé à chaque tour suivant.

Consommateur 3 : prompt système renvoyé à chaque tour

Le prompt système OpenClaw (5K-10K tokens) définit ses capacités. Il est renvoyé à chaque tour. 50 échanges par jour = 250K-500K tokens rien que pour le prompt système.

Consommateur 4 : mauvais choix de modèle

Claude propose Haiku (économique), Sonnet (équilibré), Opus (puissant et cher) — écart de prix d’environ 15×.

Beaucoup mettent Opus par défaut et l’utilisent pour des conversions de format ou des requêtes simples. Comme prendre un char d’assaut pour acheter une bouteille d’eau au supermarché — ça marche, mais c’est absurde.

Consommateur 5 : heartbeat mal configuré

Le heartbeat ping périodiquement l’API. Intervalle à 30 s = 120 appels/heure. Chaque appel est petit, mais la fréquence tue le budget.

J’ai vu un cas : heartbeat trop court, 3600 appels/mois sans aucun travail réel — l’argent part avant la valeur.

La vérité sur la consommation mémoire

OpenClaw ralentit parfois faute de mémoire, pas de réseau.

Beaucoup pensent qu’un outil de chat tourne avec 2 Go. En pratique, ce n’est pas le cas.

OpenClaw est gourmand en RAM : processus Node.js, WebSocket, mémoire de session, interface web — ~1,5 Go rien que pour tourner. Avec 2 Go alloués, c’est courir un marathon avec 50 kg sur le dos — théoriquement possible, mais le crash est proche.

Mon expérience :

  • 2 Go : démarre, puis ralentit et crash
  • 4 Go : usage personnel quotidien
  • 8 Go : fluide pour équipe ou usage intensif
  • 16 Go : production, exécution longue sans stress

Et les fuites mémoire : après une semaine, 1,8 Go peut monter à 3,5 Go, puis 4 Go+. Le système swap sur disque, les réponses s’effondrent.

Sur un VPS 4 Go, tout allait bien — puis après deux semaines, réponses très lentes. docker stats : 3,8 Go utilisés, moins de 200 Mo libres. Redémarrage du conteneur : retour à 1,8 Go instantanément.

La lenteur n’est pas toujours la faute d’OpenClaw — souvent, le VPS est sous-dimensionné.

Analyse des logs et monitoring — traquer OpenClaw

Lire correctement les logs Docker

Comment savoir ce qu’OpenClaw fait vraiment ?

Les logs. Mais beaucoup ne savent pas les lire — ou ne comprennent pas ce qu’ils voient.

Logs en temps réel

docker logs -f openclaw-gateway

Sortie continue : chaque message, chaque outil appelé, tokens consommés.

Dernières erreurs

docker logs openclaw-gateway 2>&1 | tail -50

Les 50 dernières lignes — 90 % des problèmes de démarrage s’y trouvent.

Identifiants d’erreur clés

  • WebSocket Error 1008 : auth expirée, effacer le cache navigateur
  • No API key found for anthropic : clé API mal configurée
  • Error: Address already in use : port occupé
  • FATAL ERROR: Reached heap limit : mémoire insuffisante, upgrade nécessaire

Une fois, OpenClaw ne se connectait plus — WebSocket Error 1008 en boucle. Cause : j’avais modifié l’heure système, le token était invalide. Suppression du localStorage : résolu.

Outil openclaw-telemetry

Pour un monitoring plus pro, essayez openclaw-telemetry.

Il enregistre commandes, prompts et appels d’outils. Collecte via syslog, export vers SIEM pour audit. Désensibilisation automatique et chaîne de hachage anti-falsification.

Un peu lourd pour un usage perso. En entreprise ou avec des données clients, très utile.

Installation documentée sur GitHub. Je ne l’utilise pas (dev perso), mais des équipes le déploient avec satisfaction.

Commandes de monitoring des ressources

docker stats openclaw-gateway

Affichage en temps réel :

CONTAINER ID   NAME               CPU %   MEM USAGE / LIMIT   MEM %   NET I/O
a1b2c3d4e5f6   openclaw-gateway   12.5%   1.85GB / 4GB       46.25%  15.2MB / 8.3MB

Indicateurs clés :

  • CPU : pics à 80-100 % OK (tâche en cours) ; haut en continu = problème
  • Mémoire : le plus critique — > 90 % = upgrade
  • Pourcentage mémoire : > 80 % alerte, > 90 % crash imminent

Surveillez régulièrement. Croissance continue (1,8 Go → 2,5 Go → 3,2 Go) = fuite — redémarrer ou reset de session.

Un matin, 3,6 Go sur 4 Go, conteneur encore actif. Le lendemain : crash. Logs pleins de Out of memory. Depuis, je redémarre dès 3 Go.

7 stratégies d’optimisation — de 40 % à 80 % d’économies

Stratégie 1 : réinitialisation régulière (40-60 %)

La plus simple et la plus efficace.

Pourquoi ça marche ?

Le reset vide le contexte cumulé — historique, sorties d’outils, résultats intermédiaires. Chaque conversation repart à zéro, sans dizaines de milliers de tokens de bagage.

Comment ?

# Méthode 1 : ligne de commande
openclaw "reset session"

# Méthode 2 : supprimer les fichiers de session
rm -rf ~/.openclaw/agents.main/sessions/*.jsonl

# Méthode 3 : commande intégrée
# Dans le dialogue OpenClaw
/compact

Bonnes pratiques

Reset après chaque tâche indépendante : article terminé, PR revue, bug corrigé.

Vous gardez un OpenClaw « léger » — rapide et économique.

Peur de perdre le contexte ? Oui — mais le contexte de la tâche précédente sert rarement à la suivante. Les recherches pour un article n’aident pas à déboguer du code. Pourquoi les garder en mémoire ?

Mesure : 347 $/mois → 195 $ après reset régulier. 40 %+ rien qu’avec ça.

Stratégie 2 : isoler les grosses sorties (20-30 %)

Logs complets, exports de config, grands jeux de données — une fois dans la session principale, ils collent à chaque requête suivante.

Solution : session indépendante

# Session debug pour une grosse config
openclaw --session debug "show full system config"

# Copier l'essentiel, revenir à la session principale

Comme trier les déchets — les gros objets à part.

Exemple concret

Analyser 300 lignes de log en session principale = 300 lignes permanentes dans le contexte. Ma méthode :

  1. --session analyze-log pour l’analyse
  2. Conclusion : « exception null pointer ligne 127 »
  3. Copier la conclusion en session principale
  4. Fermer la session debug

Un peu plus de travail, mais des économies réelles sur les gros fichiers.

Stratégie 3 : bascule intelligente de modèle (50-80 %)

L’effet le plus marqué — souvent ignoré.

Trois modèles Claude :

  • Haiku : rapide et économique
  • Sonnet : équilibre performance/coût
  • Opus : le plus puissant, 15× le prix de Haiku

Opus pour tout, c’est prendre l’avion pour aller au supermarché.

Classification des tâches

Haiku :

  • Conversion de format (JSON/YAML, Markdown/HTML)
  • Requêtes simples (« quel langage est ce code ? »)
  • Extraction (« lister tous les noms de fonctions »)

Sonnet :

  • Revue de code
  • Rédaction d’articles et documentation
  • Analyse d’architecture

Opus :

  • Conception système
  • Refactoring massif
  • Décisions critiques (choix technologiques, risques)

Exemple de configuration

{
  "defaultModel": "claude-3-haiku",
  "complexTaskModel": "claude-3-5-sonnet",
  "triggerKeywords": ["analyse", "refactoring", "architecture", "conception"]
}

Haiku par défaut, bascule manuelle pour le complexe — 80 % des opérations au tarif le moins cher.

Avec la stratégie 1 : 195 $ → 68 $/mois. La bascule seule : ~65 % d’économies.

Stratégie 4 : optimisation du cache (30-50 %)

L’API Claude met en cache les prompts identiques ou similaires — les requêtes suivantes coûtent moins.

Comment en profiter ?

  1. Activer le prompt cache (souvent activé par défaut)
  2. Baisser temperature à ~0,2 pour des sorties stables et un meilleur taux de cache
  3. Heartbeat pour maintenir le cache : 5-10 min, pas 30 s
{
  "temperature": 0.2,
  "enablePromptCaching": true,
  "heartbeatInterval": 300000  // 5 min, millisecondes
}
  1. Relais API avec cache : certains relais tiers optimisent davantage

Effet réel

Le prompt système (5K-10K tokens) n’est facturé qu’une fois pendant la validité du cache. 10 requêtes/heure : 1 facturation au lieu de 10.

Peu visible si usage rare ; 30-50 % d’économies en usage intensif (dizaines de conversations/jour).

Stratégie 5 : limiter la fenêtre de contexte (20-40 %)

Fenêtre par défaut : 400K tokens. Plus c’est grand, plus on remplit sans s’en rendre compte.

Comme un grand sac à dos — on surcharge ; un petit sac force à trier.

Configuration

{
  "maxContextTokens": 100000  // de 400K à 100K
}

Pourquoi c’est efficace

OpenClaw force un nettoyage quand le contexte approche la limite — reset ou résumé. Fini les dizaines de tours d’historique traînant.

100K suffit pour la plupart des tâches. Sauf refactoring massif ou analyse de milliers de lignes.

Attention

Trop petit = « amnésie » sur les tâches vraiment volumineuses.

Recommandation :

  • Quotidien : 50K-100K
  • Tâches complexes : 200K
  • Très grands projets : 400K par défaut

100K : mon sweet spot — économies sans friction.

Stratégie 6 : modèles locaux (60-80 %)

Si vous acceptez la complexité, certaines tâches peuvent coûter zéro.

Principe

Via Ollama (Llama, Mistral), OpenClaw délègue les tâches simples au local — pas d’appel Claude, pas de facture.

Adapté :

  • Conversion de format
  • Requêtes simples (« lister les TODO »)
  • Extraction d’information

Peu adapté :

  • Revue de code (qualité inférieure à Claude)
  • Contenu créatif
  • Raisonnement complexe

Exemple

# Installer Ollama et tirer un modèle
ollama pull llama3.2

# Config OpenClaw pour tâches simples en local
{
  "localModel": "llama3.2",
  "localModelTasks": ["format", "extract", "simple-query"]
}

Retour d’expérience

La config locale est pénible ; la qualité inférieure à Claude. Format conversion : 2-3 erreurs sur 10, corrections manuelles.

Budget serré ou tâches répétitives simples : 60-80 % d’économies sur cette part.

Stratégie 7 : désactiver Skills et outils inutiles

Chaque Skill activé ajoute sa documentation au contexte (envoyée à l’API) — surtout visible sur petits modèles.

Audit

Automatisation navigateur — dernière utilisation quand ? Gmail — OpenClaw doit-il envoyer vos mails ?

Ma config

Conservé :

  • Fichiers (obligatoire)
  • Git (fréquent)
  • Bash (debug)

Désactivé : navigateur, calendrier, mail. Des milliers de tokens de prompt en moins par requête.

Exemple

{
  "enabledSkills": [
    "file-operations",
    "git",
    "bash"
  ],
  "disabledSkills": [
    "browser-automation",
    "gmail",
    "calendar"
  ]
}

Seul : 10-15 %. Combiné aux autres stratégies : effet cumulatif.

Table de dépannage — 90 % des problèmes en 5 minutes

SymptômeCause probableDiagnostic 5 sCorrectif rapide
WebSocket Error 1008Auth expiréeMessage consoleEffacer localStorage (F12 → Application → Local Storage → supprimer openclaw-auth-token)
Conteneur s’arrête au démarrageClé API / portdocker compose ps → Exited1. docker compose logs
2. Variables d’env
3. Port occupé
No API key foundClé mal configuréeErreur explicite dans les logsVérifier la clé et le passage au conteneur
Mémoire qui monteFuite / sessionsdocker stats MEM %Court : restart
Moyen : reset session
Long : VPS ≥ 4 Go
Timeout installation SkillsTéléchargement GoPremière installationRecliquer Install — cache accélère
Timeout automatisation navigateurPage lente / ID changésnapshot ou click timeout1. --timeout-ms
2. snapshot --labels
3. Chemin Chromium
control ui requires HTTPSAccès HTTPUI inaccessibleURL avec token : http://YOUR-IP:18789/?token=YOUR_TOKEN

Astuces pratiques :

Astuce 1 : WebSocket — solution ultime

Si localStorage ne suffit pas :

# Désactiver le pairing (réseau interne uniquement)
docker run -e OPENCLAW_DISABLE_DEVICE_PAIRING=true openclaw/openclaw

Astuce 2 : mémoire ou réseau ?

# Surveiller plusieurs indicateurs
watch -n 1 'docker stats openclaw-gateway --no-stream && curl -s https://api.anthropic.com'

Mémoire stable + lenteur = réseau ; mémoire qui monte = ressources.

Astuce 3 : trop de logs ?

# Erreurs et avertissements seulement
docker logs openclaw-gateway 2>&1 | grep -E "ERROR|WARN|FATAL"

Des milliers de lignes filtrées → ERROR clé : clé API expirée.

Réglages avancés — tirer le maximum d’OpenClaw

Optimisations de base faites ? Voici la suite.

Gestion avancée du contexte

Triangulation du contexte (Context Triangulation)

N’injectez pas tout le fichier — seulement les fragments pertinents. Pour modifier une fonction :

  • Son code
  • Signatures des fonctions appelées
  • Types associés

Réduction de 70-80 % du contexte.

Architecture d’ancrage global en couches (TGAA)

Maintenez un ARCHITECTURE.md à la racine avec la conception haut niveau. Pour la vue d’ensemble, OpenClaw lit ce fichier au lieu de scanner tout le dépôt.

Un README.md par module décrit son rôle — OpenClaw comprend la structure sans charger tout le code.

Chargement dynamique des outils

Ne chargez pas toutes les définitions d’outils d’un coup. À la demande : outils fichiers quand nécessaire, Git quand nécessaire.

Config un peu plus technique — ~30 % de prompt système en moins.

Rafraîchissement mémoire pré-compression

Avant reset ou résumé, écrire l’essentiel dans MEMORY.md. La nouvelle session lit ce fichier compact pour reprendre.

# Sauvegarder avant reset
openclaw "écrire les décisions clés et todos dans MEMORY.md"

# Reset
openclaw "reset session"

# Reprendre
openclaw "lire MEMORY.md et continuer le travail"

Durcissement Docker

En janvier 2026, Bitdefender a divulgué CVE-2026-25253 : des centaines d’instances OpenClaw mal configurées exposaient clés API et données sensibles. Corrigé — mais la leçon reste : sécurisez.

Exécution non-root

services:
  openclaw-gateway:
    user: "1000:1000"  # utilisateur non privilégié

Principe du moindre privilège

docker run \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  --read-only \
  --tmpfs /tmp \
  openclaw/openclaw

Isolation réseau

Sans accès externe (fichiers locaux uniquement) :

services:
  openclaw-gateway:
    network_mode: none

Accès limité ? Proxy avec liste blanche.

Protection des variables d’environnement

Pas de clé API en clair dans docker-compose.yml :

services:
  openclaw-gateway:
    env_file:
      - .env  # ANTHROPIC_API_KEY=sk-xxx

Ajoutez .env au .gitignore.

Bonnes pratiques production

Rotation des logs

services:
  openclaw-gateway:
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

Max ~30 Mo de logs.

Mises à jour régulières

OpenClaw évolue vite — perf et sécurité. Vérification mensuelle :

docker pull openclaw/openclaw:latest
docker compose up -d

Alertes monitoring

#!/bin/bash
MEM_PERCENT=$(docker stats openclaw-gateway --no-stream --format "{{.MemPerc}}" | sed 's/%//')
if (( $(echo "$MEM_PERCENT > 85" | bc -l) )); then
    echo "Mémoire OpenClaw > 85 % !" | mail -s "Alerte OpenClaw" [email protected]
fi

Cron horaire.

VPN ou Tailscale plutôt qu’exposition publique

Accès distant : ne pas exposer le port sur Internet. Tailscale = réseau privé, simple et sûr.

# Installer Tailscale
curl -fsSL https://tailscale.com/install.sh | sh

# Démarrer et authentifier
sudo tailscale up

# Accès OpenClaw via Tailscale, sans IP publique

Ma config : café, aéroport — accès sécurisé à l’instance OpenClaw à la maison.

Conclusion

De 347 $ à 68 $, de 23 s à 4 s — chiffres réels, pas marketing.

En retrospectif, les problèmes de performance OpenClaw tiennent à trois choses :

  1. Contrôler le contexte : ne pas laisser cumuler sans fin
  2. Choisir le bon modèle : tâches simples = modèle économique
  3. Monitorer les ressources : détecter la mémoire insuffisante tôt

Pas besoin des 7 stratégies. Mon conseil :

  • Immédiat : docker stats — si < 4 Go, upgrade
  • Cette semaine : Haiku par défaut + cache (temperature 0,2)
  • Habitude : reset après chaque tâche (/compact)

Ces trois étapes : au moins 50 % d’économies.

OpenClaw est un bon outil — mais un outil. Son efficacité dépend de votre usage. Comprendre son fonctionnement, dimensionner les ressources, adopter de bonnes habitudes — le retour sur investissement est réel.

Problème ? Consultez les logs et la table de dépannage — 90 % résolus en 5 minutes. Sinon, la communauté GitHub Issues est active.

Que votre OpenClaw soit rapide et économique.

Processus complet d'optimisation des performances OpenClaw

Étapes complètes, de la vérification mémoire à l'optimisation des coûts

⏱️ Estimated time: 2 hr

  1. 1

    Step 1: Étape 1 : diagnostiquer les goulots d'étranglement actuels

    Utilisez les commandes de monitoring Docker pour diagnostiquer l'utilisation des ressources :

    • docker stats openclaw-gateway (occupation en temps réel)
    • docker logs -f openclaw-gateway (logs en direct, observer la consommation de tokens)
    • docker logs openclaw-gateway 2>&1 | grep -E "ERROR|WARN|FATAL" (filtrer les erreurs)

    Indicateurs à surveiller :
    • Mémoire &gt; 80 % : upgrader le VPS à au moins 4 Go
    • CPU &gt; 90 % en continu : vérifier boucles infinies ou processus anormaux
    • Log « Reached heap limit » : mémoire insuffisante, upgrade nécessaire

    Astuce : mémoire stable mais réponse lente = probablement réseau ; mémoire qui monte = ressources insuffisantes.
  2. 2

    Step 2: Étape 2 : configurer la bascule intelligente de modèle (effet le plus marqué)

    Modifiez la configuration OpenClaw pour un classement des tâches :

    Exemple (JSON) :
    &#123;
    "defaultModel": "claude-3-haiku",
    "complexTaskModel": "claude-3-5-sonnet",
    "triggerKeywords": ["analyse", "refactoring", "architecture", "conception"]
    &#125;

    Principes :
    • Haiku : conversion de format, requêtes simples, extraction de texte
    • Sonnet : revue de code, création de contenu, analyse technique
    • Opus : conception d'architecture, refactoring complexe, décisions critiques

    Effet mesuré : Haiku par défaut, 80 % des opérations moins chères ; combiné aux autres stratégies, 50-80 % d'économies.
  3. 3

    Step 3: Étape 3 : activer le cache et limiter le contexte

    Configurez le cache et la limite de fenêtre de contexte :

    Configuration cache (JSON) :
    &#123;
    "temperature": 0.2,
    "enablePromptCaching": true,
    "heartbeatInterval": 300000,
    "maxContextTokens": 100000
    &#125;

    Paramètres :
    • temperature: 0.2 (moins de randomisation, meilleur taux de cache)
    • enablePromptCaching: true (cache des prompts)
    • heartbeatInterval: 300000 (5 min, en millisecondes)
    • maxContextTokens: 100000 (limite de 400K à 100K)

    Effets :
    • Cache : 30-50 % d'économies (usage intensif)
    • Limite de contexte : 20-40 % (nettoyage forcé périodique)
  4. 4

    Step 4: Étape 4 : désactiver les Skills inutiles

    Vérifiez et désactivez les Skills peu utilisés :

    Exemple (JSON) :
    &#123;
    "enabledSkills": ["file-operations", "git", "bash"],
    "disabledSkills": ["browser-automation", "gmail", "calendar"]
    &#125;

    Stratégie :
    • Conserver l'essentiel : fichiers, Git, Bash
    • Désactiver : automatisation navigateur, mail, calendrier

    Effet : chaque Skill désactivé retire des milliers de tokens de prompt système — 10-15 % cumulés.
  5. 5

    Step 5: Étape 5 : adopter la réinitialisation régulière des sessions

    Réinitialisez la session après chaque tâche :

    Trois méthodes :
    • Méthode 1 : openclaw "reset session" (ligne de commande)
    • Méthode 2 : rm -rf ~/.openclaw/agents.main/sessions/*.jsonl (suppression directe)
    • Méthode 3 : saisir /compact dans le dialogue

    Bonnes pratiques :
    • Article terminé → reset
    • PR revue → reset
    • Bug corrigé → reset
    • Tâche indépendante terminée → reset

    Astuce avancée (rafraîchissement mémoire pré-compression) :
    1. openclaw "écrire les décisions clés et todos dans MEMORY.md"
    2. openclaw "reset session"
    3. openclaw "lire MEMORY.md et reprendre le travail"

    Effet mesuré : 40-60 % d'économies — la méthode la plus simple et efficace.
  6. 6

    Step 6: Étape 6 : isoler les opérations à grosse sortie

    Utilisez des sessions indépendantes pour gros fichiers et longs logs :

    Flux :
    1. openclaw --session debug "show full system config" (session dédiée)
    2. Copier les informations clés
    3. Revenir à la session principale
    4. Fermer la session debug — la grosse sortie ne pollue pas la session principale

    Cas d'usage :
    • Logs complets (centaines de lignes)
    • Export de configuration
    • Analyse de grands jeux de données (&gt; 100K tokens)

    Exemple : analyser 300 lignes de log en session temporaire, obtenir la conclusion (« exception null pointer ligne 127 »), puis traiter en session principale — 20-30 % d'économies.
  7. 7

    Step 7: Étape 7 : configurer monitoring et alertes

    Déployez un script de monitoring automatisé :

    Script (Bash) :
    #!/bin/bash
    MEM_PERCENT=&#36;(docker stats openclaw-gateway --no-stream --format "&#123;&#123;.MemPerc&#125;&#125;" | sed 's/%//')
    if (( &#36;(echo "&#36;MEM_PERCENT &gt; 85" | bc -l) )); then
    echo "Mémoire OpenClaw &gt; 85 % !" | mail -s "Alerte OpenClaw" [email protected]
    fi

    Déploiement :
    • Sauvegarder dans /usr/local/bin/openclaw-monitor.sh
    • chmod +x /usr/local/bin/openclaw-monitor.sh
    • crontab : 0 * * * * /usr/local/bin/openclaw-monitor.sh

    Seuils :
    • Mémoire &gt; 85 % : alerte
    • Mémoire &gt; 90 % : redémarrer le conteneur
    • Logs disque &gt; 100 Mo : rotation des logs

    Rotation (docker-compose.yml) :
    logging:
    driver: "json-file"
    options:
    max-size: "10m"
    max-file: "3"

FAQ

Pourquoi OpenClaw consomme-t-il autant de tokens, avec des coûts mensuels de plusieurs centaines de dollars ?
5 causes principales :

• Contexte cumulé sans limite : 150K tokens après 10 tours, tout l'historique renvoyé à chaque requête
• Stockage illimité des sorties d'outils : logs et fichiers lus restent dans le contexte
• Prompt système renvoyé à chaque tour : 5K-10K tokens par conversation
• Mauvais choix de modèle : Opus pour des tâches simples, 15× le prix de Haiku
• Heartbeat mal configuré : intervalle trop court, centaines d'appels API inutiles par heure

Solutions : reset régulier (/compact) + bascule intelligente (Haiku par défaut) + cache — 50-80 % d'économies.
OpenClaw répond lentement (20+ secondes), comment optimiser ?
La lenteur vient souvent de la mémoire, pas du réseau :

Diagnostic :
• docker stats openclaw-gateway
• Mémoire &gt; 80 % = configuration insuffisante
• Croissance continue (1,8 Go → 2,5 Go → 3,2 Go) = fuite mémoire

Recommandations :
• 2 Go : démarre mais crashs fréquents (déconseillé)
• 4 Go : minimum usage personnel
• 8 Go : équipe ou usage intensif
• 16 Go : production

Correctifs :
• Court terme : docker restart openclaw-gateway
• Moyen terme : /compact
• Long terme : VPS à au moins 4 Go

Combiner avec maxContextTokens à 100K.
Quand utiliser Haiku, Sonnet ou Opus ?
Selon la complexité — écart de prix jusqu'à 15× :

Haiku (rapide et économique) :
• Conversion JSON/YAML, Markdown/HTML
• Requêtes simples, extraction de texte

Sonnet (équilibre) :
• Revue de code, rédaction, analyse technique

Opus (puissant et cher) :
• Architecture, refactoring massif, décisions critiques

Config pratique : Haiku par défaut, 80 % des opérations moins chères ; avec reset de session, 65 % d'économies.
Comment résoudre WebSocket Error 1008 ?
Erreur d'auth expirée — 3 solutions :

1. Effacer localStorage du navigateur
F12 → Application → Local Storage → supprimer openclaw-auth-token → recharger

2. Désactiver le pairing (Docker en réseau interne)
docker run -e OPENCLAW_DISABLE_DEVICE_PAIRING=true openclaw/openclaw

3. Vérifier l'heure système
Un décalage d'horloge invalide le token — corriger puis effacer localStorage

Autres erreurs : No API key found (variables d'env), Address already in use (port), FATAL ERROR: Reached heap limit (mémoire).
Le reset de session efface-t-il le contexte ? Comment garder l'essentiel ?
Oui, mais la technique de rafraîchissement pré-compression préserve l'essentiel :

1. openclaw "écrire décisions et todos dans MEMORY.md"
2. openclaw "reset session"
3. openclaw "lire MEMORY.md et continuer"

À conserver : projets multi-jours, décisions d'architecture, listes de tâches

Pas nécessaire : recherches pour un article, logs temporaires, conversions ponctuelles

Pratique : reset après chaque tâche indépendante — OpenClaw léger, rapide et économique. Mesure : de 347 $ à 195 $, 40 %+ d'économies.
Quel effet du cache ? Pour quels usages ?
Effet maximal pour les utilisateurs intensifs :

Config :
&#123;
"temperature": 0.2,
"enablePromptCaching": true,
"heartbeatInterval": 300000
&#125;

Principe : prompt système (5K-10K tokens) facturé une fois pendant la validité du cache ; 10 requêtes/heure = 1 facturation au lieu de 10

Adapté : usage fréquent (30-50 %), travail continu sur tâches similaires

Peu adapté : usage rare, tâches très variées

Heartbeat 5-10 min pour maintenir le cache ; 30 s augmente les coûts.
Le conteneur s'arrête juste après le démarrage — diagnostic rapide ?
Généralement une erreur de configuration :

1. docker compose ps — Exited = échec

2. docker logs openclaw-gateway 2&gt;&1 | tail -50

3. Corriger selon l'erreur :
• No API key found : ANTHROPIC_API_KEY dans docker-compose.yml
• Address already in use : changer le port ou tuer le processus
• Permission denied : permissions fichiers ou utilisateur non-root

4. docker exec openclaw-gateway env | grep ANTHROPIC

5. netstat -tuln | grep 18789

docker compose logs -f pour le suivi en temps réel.

12 min de lecture · Publié le: 5 févr. 2026 · Mis à jour le: 27 juil. 2026

Commentaires

Connectez-vous avec GitHub pour laisser un commentaire

Easton BlogEaston Blog