ClawTrace

Qu’est-ce que ClawTrace ?

ClawTrace fournit l’observabilité pour les agents OpenClaw. Il vous aide à comprendre ce qui s’est passé lors des exécutions d’agents — ce qui a échoué, où les coûts ont augmenté, et quoi changer ensuite — afin d’améliorer la fiabilité et de réduire les dépenses.

Le produit combine des vues au niveau des exécutions et des traces détaillées des appels LLM, de l’utilisation d’outils et de la délégation vers des sous-agents. Il inclut également « Tracy », un agent interactif qui analyse les données d’exécution en direct et fournit des recommandations adaptées au contexte.

Fonctionnalités principales

• Traçage d’exécution interactif (arbre de traces avec charges utiles) : Inspectez chaque appel LLM, utilisation d’outil et délégation vers un sous-agent dans une exécution pour identifier précisément où les choses ont mal tourné.
• Visibilité des coûts par exécution et par étape : Voyez comment les dépenses évoluent au cours d’une exécution d’agent et creusez dans les pics de coût par étape pour repérer les fuites budgétaires.
• Diagnostic des échecs et mise en évidence des causes probables : Tracez les comportements instables et mettez en lumière les causes probables avec des actions suggérées pour améliorer.
• Cartographie des relations au niveau graphe (graphe d’appels) : Visualisez comment agents, outils et modèles s’interconnectent sur l’ensemble de la trajectoire.
• Vue chronologique des goulots d’étranglement et du parallélisme : Utilisez une chronologie de style diagramme de Gantt pour repérer les goulots d’étranglement et comprendre le parallélisme entre les étapes.
• Tableaux de bord des trajectoires pour la surveillance : Consultez toutes les trajectoires avec métriques, tendances quotidiennes, utilisation de tokens et drilldown au niveau des exécutions.
• Agent « Tracy » pour une analyse guidée : Demandez pourquoi une exécution a échoué, où se trouve un goulot d’étranglement ou comment réduire les coûts ; Tracy s’adapte à la page/contexte affiché.
• Réponses basées sur des données en direct : Les réponses sont générées à partir de données en direct, et non de tableaux de bord obsolètes ou de rapports retardés.
• Suivi de conversation : Tracy se souvient de la conversation et peut approfondir avec des questions de suivi.

Comment utiliser ClawTrace

1. Installez le plugin ClawTrace sur votre agent OpenClaw : openclaw plugins install @epsilla/clawtrace.
2. Authentifiez-vous avec votre clé d’observation : openclaw clawtrace setup.
3. Redémarrez la passerelle : openclaw gateway restart.
4. Exécutez votre agent normalement : les trajectoires sont transmises en continu vers ClawTrace, où vous pouvez inspecter traces, spans, tokens et coûts en temps réel.
5. Utilisez Tracy pour le diagnostic et les recommandations : Posez des questions sur les échecs, goulots d’étranglement ou réduction des coûts, puis suivez pour affiner l’analyse.

Cas d’utilisation

• Débogage d’un agent OpenClaw instable : Quand le comportement devient incohérent, utilisez les traces d’exécution et la navigation dans l’arbre de traces pour trouver la cause probable et voir les actions pour améliorer la fiabilité.
• Investigation d’un pic de coût : Si les coûts augmentent de manière inattendue, inspectez les dépenses par exécution d’agent et par étape pour identifier les étapes qui entraînent une utilisation accrue de tokens ou de dépenses.
• Élimination des boucles inefficaces : Quand les agents bouclent, utilisez la chronologie et le graphe d’appels pour repérer où le progrès stagne et quelle partie de la trajectoire ajuster.
• Comparaison des améliorations après changements : Utilisez Tracy pour évaluer une exécution après des modifications comme passer à des modèles moins chers quand possible ou scriptifier des étapes répétables pour stabiliser les exécutions.
• Surveillance opérationnelle sur de nombreuses trajectoires : Utilisez le tableau de bord des trajectoires pour examiner tendances quotidiennes, utilisation de tokens et drilldowns au niveau des exécutions afin de détecter les problèmes récurrents sur les déploiements.

FAQ

• ClawTrace fonctionne-t-il avec les agents OpenClaw ? Oui. Le site décrit ClawTrace spécifiquement comme « observabilité pour les agents OpenClaw », avec un plugin installable et une transmission de trajectoires.

• Que analyse Tracy ? Tracy analyse le contexte d’exécution/trajectoire affiché et répond aux questions sur pourquoi une exécution a échoué, où sont les goulots d’étranglement et comment réduire les coûts. Il utilise des données en direct.

• Comment les traces et détails de coûts apparaissent-ils dans ClawTrace ? ClawTrace fournit un arbre de traces interactif avec charges utiles pour les appels LLM, utilisation d’outils et délégation vers sous-agents, plus des vues pour les dépenses par exécution d’agent et par étape.

• Dois-je configurer l’intégration avant de l’utiliser ? Oui. Le workflow de base est l’installation du plugin, l’authentification avec une clé d’observation et le redémarrage de la passerelle OpenClaw.

• Comment les données restent-elles à jour ? Le site indique que les réponses de Tracy proviennent de données en direct, sans tableaux de bord obsolètes ni rapports retardés.

Alternatives

• Outils d’observabilité/télémétrie LLM polyvalents : Ils fournissent des logs, traces et métriques de tokens/coûts pour les appels LLM, mais ne proposent pas de vues de trajectoire spécifiques à OpenClaw comme les relations de graphe d’appels et le diagnostic style Tracy.
• Frameworks de traçage open source pour workflows LLM : Si vous avez déjà une pipeline de traçage, vous pouvez créer des tableaux de bord et vues de débogage personnalisés pour les étapes d’agents et appels d’outils, mais vous perdrez le workflow prêt-à-l’emploi « échec d’exécution → cause racine probable → correctifs suivants ».
• Tableaux de bord de monitoring et d’analytique de workflows : Pour les équipes axées sur les métriques opérationnelles (latence, débit, taux d’erreur), les outils d’analytique aident à détecter les problèmes, mais ne fournissent pas de traces d’exécution par étape avec visibilité des payloads et drilldown interactif de trajectoire.