Configuration de l'espace de travail OpenClaw : Leçons tirées de deux mois d'utilisation

Un utilisateur d'OpenClaw a partagé des leçons détaillées après deux mois d'utilisation de l'agent d'intelligence artificielle pour le codage, soulignant que la configuration de l'espace de travail compte plus que l'outil lui-même. Le développeur a constaté qu'un espace de travail bien construit améliore l'expérience de 5 à 10 fois par rapport à une configuration standard.

Configuration de SOUL.md

Les instructions génériques comme "soyez utile et professionnel" ont un impact minimal. Les fichiers SOUL.md efficaces devraient :

• Inclure des comportements spécifiques comme "commencez par la réponse, le contexte après" ou "si vous ne savez pas, dites-le, n'inventez pas"
• Rester entre 50 et 150 lignes maximum, car chaque ligne consomme des tokens de la fenêtre de contexte
• Se concentrer sur les cas limites plutôt que sur les scénarios normaux : ce que l'agent devrait faire quand il ne sait pas quelque chose, quand les demandes sont hors de portée, ou quand les priorités entrent en conflit
• Tester chaque ligne en se demandant : si elle est supprimée, le comportement de l'agent change-t-il ? Sinon, supprimez-la

AGENTS.md comme procédure opérationnelle standard

Ce fichier devrait répondre à "comment travaillez-vous" plutôt qu'à "qui êtes-vous" (ce qui est le rôle de SOUL.md). Principales observations :

• La règle la plus précieuse ajoutée : "avant toute tâche non triviale, exécutez d'abord memory_search" pour éviter les suppositions
• Quand l'agent fait des erreurs, ajoutez des règles pour éviter qu'elles ne se reproduisent, les instructions négatives ("ne faites jamais X sans vérifier Y") fonctionnant souvent mieux que les positives
• Les règles dans les fichiers de démarrage sont uniquement consultatives — le modèle les suit parce qu'on le lui demande, pas parce qu'elles sont imposées
• Pour les règles qui ne peuvent vraiment pas être enfreintes, utilisez la politique des outils et la configuration du bac à sable au lieu de vous fier à du markdown fortement formulé

Gestion de MEMORY.md

Ce fichier se charge à chaque session, il ne devrait donc contenir que les informations nécessitant une rétention permanente :

• Inclure les décisions clés, les préférences des utilisateurs, les leçons opérationnelles et les règles tirées des erreurs
• Les informations quotidiennes vont dans les fichiers memory/AAAA-MM-JJ.md que l'agent recherche quand nécessaire
• Limites strictes : 20 000 caractères par fichier, 150 000 au total sur tous les fichiers de démarrage — dépasser provoque une troncature silencieuse
• Les instructions tapées dans le chat ne persistent PAS une fois que la compaction du contexte se produit
• Connectez votre espace de travail à git pour récupérer les fichiers MEMORY accidentellement écrasés depuis l'historique des commits

Optimisation de USER.md et des compétences

Le fichier USER.md est sous-estimé — inclure le contexte, les préférences, le fuseau horaire et le contexte de travail réduit les répétitions et économise des tokens. Pour les compétences :

• Avoir 30 compétences installées n'injecte pas 30 fichiers de compétences complets dans chaque invite, mais la liste des compétences elle-même consomme du contexte
• Réduire de plus de 15 compétences à 5 a sensiblement amélioré la qualité des résultats
• Test : si une compétence disparaissait demain, le remarqueriez-vous ? Sinon, désinstallez-la

Problèmes courants avec une mauvaise configuration

Quand la configuration de la persona n'est pas solide, ces problèmes apparaissent rapidement :

• L'agent continue de dériver, nécessitant des corrections constantes dans une boucle sans fin
• Tokens gaspillés sur des actions inefficaces comme ouvrir un navigateur quand un script fonctionnerait
• Trop de compétences chargées, alourdissant le contexte et empêchant un fonctionnement correct
• Résultats incohérents pour la même tâche à travers différentes sessions

Le développeur, qui travaille dans le commerce électronique, a créé des personas pour l'approvisionnement de produits et les opérations Shopify après avoir trouvé la plupart des personas disponibles inadéquates. Il a noté que bien que chaque industrie ait des flux de travail qui pourraient être empaquetés en personas, les bonnes ressources sont dispersées sur des plateformes payantes, GitHub, des blogs aléatoires et de vieux posts, avec beaucoup de "personas" étant juste des fichiers SOUL uniques qui ne sont pas utilisables tels quels.