Dépannage d'OpenClaw : Une méthode de réinitialisation minimaliste

Procédure de réinitialisation d'OpenClaw pour les configurations instables

Lorsque les configurations d'OpenClaw deviennent instables—avec des compétences qui consomment des tokens, des agents qui signalent des complétions erronées, ou des mises à jour qui rompent les connexions—une réinitialisation complète vers une configuration minimale peut identifier la cause racine. Cette approche isole les problèmes en supprimant la complexité.

Processus de réinitialisation en cinq étapes

Étape 1 : Supprimer toutes les compétences (60 secondes)

Déplacez toutes les compétences vers une sauvegarde pour éliminer les sources courantes d'instabilité comme les boucles silencieuses, la consommation de tokens, l'injection de contexte, les écrasements de configuration ou les logiciels malveillants :

mkdir ~/.openclaw/skills-backup
mv ~/.openclaw/agents/*/skills/* ~/.openclaw/skills-backup/

Cela préserve les compétences pour une restauration ultérieure tout en testant la fonctionnalité de base de l'agent.

Étape 2 : Passer à Claude Sonnet (30 secondes)

Modifiez la configuration du modèle d'IA pour éliminer les problèmes liés au modèle :

{
  "ai": {
    "model": "claude-sonnet-4-5-20250929"
  }
}

Sonnet est recommandé car il est économique, fiable et cohérent avec l'appel d'outils. Si votre configuration fonctionne avec Sonnet mais pas avec Opus, GPT-5.4 ou des modèles locaux, le modèle était le problème.

Étape 3 : Effacer les sessions (15 secondes)

Supprimez l'historique de conversation potentiellement corrompu :

rm -rf ~/.openclaw/agents/*/sessions/*

Cela n'affecte pas SOUL.md, la mémoire, USER.md ou les configurations permanentes—seulement les données de session qui peuvent se corrompre après des mises à jour ou des changements de modèle.

Étape 4 : Simplifier SOUL.md (60 secondes)

Vérifiez votre SOUL.md actuel et remplacez-le par une version minimale si nécessaire :

cat ~/.openclaw/agents/*/SOUL.md

Remplacez par cette version de 5 lignes :

soyez direct. pas de remplissage. adaptez-vous à mon ton.
si je pose une question, répondez-y d'abord.
ne dites jamais "absolument", "excellente question" ou "je serais ravi de".
si vous ne savez pas quelque chose, dites-le.
si une tâche coûtera beaucoup de tokens, dites-le moi avant de la faire.

Ajoutez plus d'instructions progressivement en fonction de ce qui vous agace au cours de la semaine suivante.

Étape 5 : Redémarrer et tester (30 secondes)

Redémarrez OpenClaw et envoyez un message de base :

openclaw stop
openclaw start

Testez avec des requêtes simples comme "quel jour sommes-nous ?" ou "résumez cet article" avec une URL. S'il répond correctement sans comportement étrange, votre noyau fonctionne. Les problèmes venaient de ce que vous avez supprimé. Ajoutez les composants un par un, en testant après chaque ajout.

Pourquoi cela fonctionne

La plupart des configurations d'OpenClaw accumulent des compétences, des agents, des tâches planifiées, des changements de modèle et des ajustements de configuration jusqu'à ce qu'un composant provoque un effondrement. Comme tout a été ajouté simultanément, identifier la pièce problématique devient impossible. Réduire à une configuration minimale et reconstruire progressivement crée des configurations stables.

Après avoir mis en œuvre cette réinitialisation, un utilisateur a signalé une configuration stable avec un agent, Sonnet et quatre compétences (recherche web, briefing quotidien, preneur de notes et un script Python personnalisé pour le tri des e-mails) coûtant moins de 10 $/mois et fonctionnant sans problème depuis plus de quatre semaines.