Les paquets de trajectoire d’OpenClaw

Quand un agent a répondu bizarrement, échoué, ou appelé un outil inattendu, la question est toujours la même : qu’a réellement vu le modèle ? La capture de trajectoire d’OpenClaw est l’enregistreur de vol par session qui y répond. Elle enregistre une chronologie structurée pour chaque exécution, et une commande empaquette la session courante dans un paquet de support caviardé couvrant le prompt, le prompt système et les outils envoyés au modèle, quels messages de transcription et appels d’outils ont mené à une réponse, si l’exécution a expiré, été interrompue, compactée ou a rencontré une erreur de fournisseur, quels modèle, extensions, compétences et réglages d’exécution étaient actifs, et les métadonnées d’usage et de cache de prompt renvoyées par le fournisseur. Voici comment en exporter un, ce qu’il enregistre, ce que contient le paquet, comment il est stocké, et les limites.

Exporter

• Envoyez la commande d’export de trajectoire, alias trajectoire, dans la session active ; le paquet atterrit sous l’espace de travail dans un répertoire d’exports de trajectoires nommé par session et horodatage, un argument de nom relatif remplace le répertoire, et les chemins absolus ou relatifs au dossier personnel sont rejetés.
• Parce qu’un paquet peut contenir des prompts, des messages de modèle, des schémas d’outils, des résultats d’outils, des événements d’exécution et des chemins locaux, la commande de chat passe toujours par l’approbation d’exécution : approuvez l’export une fois quand vous voulez créer le paquet, et jamais avec tout autoriser. Dans les conversations de groupe, l’invite d’approbation et le résultat vont au propriétaire en privé, et le salon ne voit qu’un avis d’état qui distingue livraison confirmée, en attente et supprimée.
• C’est une commande de propriétaire : l’expéditeur doit passer l’autorisation de commande normale plus le contrôle de propriétaire du canal.
• Pour l’inspection locale ou les flux de support, la CLI sous-jacente d’export de trajectoire de session prend une clé de session et un espace de travail, plus des options pour le nom de sortie, un magasin de remplacement, un identifiant d’agent et une sortie JSON. Pour un rapport de support large de la passerelle, la documentation renvoie plutôt à la commande de diagnostics ; l’export de trajectoire sert à la chronologie détaillée par session.

La capture de trajectoire est l’enregistreur de vol par session d’OpenClaw.

Ce qui est enregistré

La capture est activée par défaut pour les exécutions d’agent. Les événements d’exécution comprennent session démarrée, métadonnées de trace, contexte compilé, prompt soumis, appel d’outil avec l’identité de l’outil et des arguments assainis, résultat d’outil avec le résultat assaini et l’issue de l’exécution, étape de repli de modèle avec le modèle source et le suivant, la raison de l’échec, la position dans la chaîne et si la chaîne a avancé, réussi ou été épuisée, modèle terminé, artefacts de trace et session terminée. Les événements de transcription sont reconstruits depuis la branche active de la session : messages d’utilisateur et d’assistant, appels et résultats d’outils, compactions, changements de modèle, étiquettes et entrées personnalisées. Les événements sont écrits en JSON Lines avec un marqueur de schéma nommant le schéma de trajectoire et sa version. Le paquet contient huit fichiers : un manifeste avec le schéma, les fichiers sources, les comptes d’événements et la liste des fichiers générés ; les événements ordonnés ; la branche de transcription active caviardée et l’en-tête de session ; des métadonnées avec la version d’OpenClaw, le système et l’environnement, le modèle, un instantané de configuration, les extensions, les compétences et les métadonnées de prompt ; des artefacts avec l’état final, les erreurs, l’usage, le cache de prompt, le nombre de compactions, le texte de l’assistant et les métadonnées d’outils ; les prompts soumis ; le dernier prompt système compilé quand il est capturé ; et les définitions d’outils envoyées au modèle quand elles sont capturées. Le manifeste liste les fichiers réellement présents dans un paquet donné, puisque certains sont omis quand la session n’a pas capturé ces données.

Stockage, désactivation, limites

• Les événements d’exécution sont stockés avec la session dans la base SQLite par agent ; l’export matérialise le paquet JSONL caviardé, et la capture en direct n’est pas un fichier annexe à côté de la session. Les fichiers annexes hérités des versions anciennes sont traités comme cibles de nettoyage par la maintenance des sessions.
• Une variable d’environnement mise à zéro avant le démarrage désactive la capture d’exécution ; la commande d’export fonctionne encore sur la branche de transcription, mais les données propres à l’exécution comme le contexte compilé, les artefacts de fournisseur et les métadonnées de prompt peuvent manquer. Les lignes sont vidées pendant le nettoyage de l’agent avec un délai par défaut de dix secondes qu’une autre variable relève sur les disques lents, sans changer les plafonds de taille.
• Le caviardage couvre les identifiants et les champs connus ressemblant à des secrets, les données d’images, les chemins d’état locaux, les chemins d’espace de travail remplacés par un espace réservé, et les chemins de dossier personnel détectés ; la capture en direct est une fenêtre glissante plafonnée à dix mébioctets, les fichiers annexes hérités sont acceptés jusqu’à cinquante, les fichiers de session jusqu’à cinquante, les événements d’exécution par export à deux cent mille, le total des événements exportés à deux cent cinquante mille, et les lignes d’événements individuelles sont tronquées au-delà de 256 kibioctets. Le caviardage est au mieux, donc relisez les paquets avant de les partager hors de votre équipe.

Les approbations d’exécution d’OpenClaw est la barrière que traverse la commande de chat, et Le basculement de modèle d’OpenClaw le mécanisme derrière les événements d’étape de repli que la chronologie enregistre.

Dépannage

Un export sans événements d’exécution signifie généralement qu’OpenClaw a été démarré avec la capture désactivée, ou que rien n’a tourné depuis ; envoyez un autre message et exportez de nouveau, et vérifiez le compte d’événements d’exécution du manifeste. Un chemin de sortie rejeté est un chemin absolu ou relatif au dossier personnel ; utilisez un nom relatif qui reste dans le répertoire d’exports. Une erreur de taille signifie que la session ou le fichier annexe a dépassé les bornes ci-dessus, donc démarrez une nouvelle session ou exportez une reproduction plus petite. Les sessions d’OpenClaw explique la branche d’où viennent les événements de transcription, et Fenêtre de contexte et compaction dans OpenClaw les événements de compaction que vous verrez dans une longue session.

Sur Diali

Sur Diali, la capture tourne à la valeur amont par défaut, activée, et un export atterrit sous l’espace de travail de l’assistant sur son volume ; l’approbation d’exécution qu’il demande est la même que celle que vous voyez pour n’importe quelle commande. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit qui peut l’atteindre.

• Une commande, un paquet caviardé, huit fichiers.
• Réservé au propriétaire, approuvé à l’exécution, privé dans les groupes.
• Dix mébioctets glissants ; relisez avant de partager.