openclaw sessions

Lister les sessions de conversation stockées.

Les listes de sessions ne sont pas des vérifications de vivacité de canal/fournisseur. Elles affichent les lignes de conversation persistées depuis les magasins de sessions. Un canal Discord, Slack, Telegram ou autre silencieux peut se reconnecter correctement sans créer de nouvelle ligne de session tant qu’aucun message n’est traité. Utilisez openclaw channels status --probe, openclaw status --deep ou openclaw health --verbose lorsque vous avez besoin d’une connectivité de canal en direct.

Les réponses openclaw sessions et Gateway sessions.list sont bornées par défaut afin que les grands magasins à longue durée de vie ne puissent pas monopoliser le processus CLI ou la boucle d’événements Gateway. La CLI renvoie par défaut les 100 sessions les plus récentes ; passez --limit <n> pour une fenêtre plus petite/grande ou --limit all lorsque vous avez intentionnellement besoin de l’intégralité du magasin. Les réponses JSON incluent totalCount, limitApplied et hasMore lorsque les appelants doivent indiquer qu’il existe davantage de lignes.

Les clients RPC peuvent passer configuredAgentsOnly: true pour conserver la source de découverte combinée large tout en ne renvoyant que les lignes des agents actuellement présents dans la configuration. Control UI utilise ce mode par défaut afin que les magasins d’agents supprimés ou présents uniquement sur disque ne réapparaissent pas dans la vue Sessions.

openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --verboseopenclaw sessions --json

Sélection de portée :

• par défaut : magasin de l’agent configuré par défaut
• --verbose : journalisation détaillée
• --agent <id> : un magasin d’agent configuré
• --all-agents : agréger tous les magasins d’agents configurés
• --store <path> : chemin de magasin explicite (ne peut pas être combiné avec --agent ou --all-agents)
• --limit <n|all> : nombre maximal de lignes à produire (par défaut 100 ; all restaure la sortie complète)

Suivre la progression de trajectoire lisible par l’humain pour les sessions stockées :

openclaw sessions tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw sessions --all-agents tail --follow

openclaw sessions tail rend les événements JSONL de trajectoire récents sous forme de lignes de progression compactes. Sans --session-key, il suit d’abord les sessions en cours d’exécution, puis la dernière session stockée. --tail <count> contrôle combien d’événements existants sont imprimés avant le mode suivi ; la valeur par défaut est 80, et 0 commence à la fin actuelle. --follow continue de surveiller les fichiers de trajectoire sélectionnés, y compris les fichiers déplacés référencés par <session>.trajectory-path.json.

La vue de progression est volontairement prudente : le texte de prompt, les arguments d’outils et les corps de résultats d’outils ne sont pas imprimés. Les appels d’outils affichent le nom de l’outil avec {...redacted...} ; les résultats d’outils affichent un état tel que ok, error ou done ; les lignes de complétion du modèle affichent le fournisseur/modèle et l’état terminal.

Exporter un lot de trajectoire pour une session stockée :

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

Il s’agit du chemin de commande utilisé par la commande slash /export-trajectory après que le propriétaire a approuvé la demande d’exécution. Le répertoire de sortie est toujours résolu dans .openclaw/trajectory-exports/ sous l’espace de travail sélectionné.

openclaw sessions --all-agents lit les magasins d’agents configurés. La découverte de sessions Gateway et ACP est plus large : elle inclut aussi les magasins présents uniquement sur disque trouvés sous la racine agents/ par défaut ou une racine session.store basée sur un modèle. Ces magasins découverts doivent se résoudre en fichiers sessions.json ordinaires à l’intérieur de la racine de l’agent ; les liens symboliques et les chemins hors racine sont ignorés.

Exemples JSON :

openclaw sessions --all-agents --json :

{  "path": null,  "stores": [    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }  ],  "allAgents": true,  "count": 2,  "totalCount": 2,  "limitApplied": 100,  "hasMore": false,  "activeMinutes": null,  "sessions": [    { "agentId": "main", "key": "agent:main:main", "model": "gpt-5" },    { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" }  ]}

Maintenance de nettoyage

Exécuter la maintenance maintenant (au lieu d’attendre le prochain cycle d’écriture) :

openclaw sessions cleanup --dry-runopenclaw sessions cleanup --agent work --dry-runopenclaw sessions cleanup --all-agents --dry-runopenclaw sessions cleanup --enforceopenclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"openclaw sessions cleanup --dry-run --fix-dm-scopeopenclaw sessions cleanup --json

openclaw sessions cleanup utilise les paramètres session.maintenance de la configuration :

• Note de portée : openclaw sessions cleanup maintient les magasins de sessions, les transcriptions et les sidecars de trajectoire. Il ne purge pas l’historique d’exécution Cron, qui est géré par cron.runLog.keepLines dans Configuration Cron et expliqué dans Maintenance Cron.

• Le nettoyage purge aussi les transcriptions primaires non référencées, les points de contrôle de Compaction et les sidecars de trajectoire plus anciens que session.maintenance.pruneAfter ; les fichiers encore référencés par sessions.json sont conservés.

• Le nettoyage signale séparément le nettoyage des sondes de courte durée d’exécution de modèle Gateway sous modelRunPruned. Cela ne correspond qu’aux clés explicites strictes de forme agent:*:explicit:model-run-<uuid>. La rétention fixe est 24h, mais elle est conditionnée par la pression : elle ne supprime les lignes de sonde obsolètes que lorsque la maintenance des entrées de session/la pression de plafond est atteinte. Lorsqu’il s’exécute, le nettoyage des exécutions de modèle a lieu avant le nettoyage global des éléments obsolètes et le plafonnement.

• --dry-run : prévisualiser combien d’entrées seraient purgées/plafonnées sans écrire.

  • En mode texte, l’essai à blanc imprime une table d’actions par session (Action, Key, Age, Model, Flags) ainsi qu’un résumé regroupé par libellé de session afin de voir ce qui serait conservé ou supprimé.

• --enforce : appliquer la maintenance même lorsque session.maintenance.mode vaut warn.

• --fix-missing : supprimer les entrées dont les fichiers de transcription sont manquants ou uniquement avec en-tête/vides, même si elles ne seraient normalement pas encore exclues par âge/nombre.

• --fix-dm-scope : lorsque session.dmScope vaut main, retirer les lignes de MP directs indexées par pairs et obsolètes laissées par les routages antérieurs per-peer, per-channel-peer ou per-account-channel-peer. Utilisez d’abord --dry-run ; appliquer le nettoyage supprime ces lignes de sessions.json et conserve leurs transcriptions comme archives supprimées.

• --active-key <key> : protéger une clé active spécifique contre l’éviction par budget disque. Les pointeurs de conversation externes durables, tels que les sessions de groupe et les sessions de chat à portée de fil, sont également conservés par la maintenance âge/nombre/budget disque.

• --agent <id> : exécuter le nettoyage pour un magasin d’agent configuré.

• --all-agents : exécuter le nettoyage pour tous les magasins d’agents configurés.

• --store <path> : exécuter sur un fichier sessions.json spécifique.

• --json : imprimer un résumé JSON. Avec --all-agents, la sortie inclut un résumé par magasin.

Lorsqu’un Gateway est joignable, le nettoyage non dry-run des magasins d’agents configurés est envoyé via le Gateway afin qu’il partage le même rédacteur de magasin de sessions que le trafic d’exécution. Utilisez --store <path> pour une réparation hors ligne explicite d’un fichier de magasin.

openclaw sessions cleanup --all-agents --dry-run --json :

{  "allAgents": true,  "mode": "warn",  "dryRun": true,  "stores": [    {      "agentId": "main",      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",      "beforeCount": 120,      "afterCount": 80,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 40,      "capped": 0    },    {      "agentId": "work",      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",      "beforeCount": 18,      "afterCount": 18,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 0,      "capped": 0    }  ]}

Compacter une session

Récupérer du budget de contexte pour une session bloquée ou surdimensionnée. openclaw sessions compact <key> est l’enveloppe de première classe autour de la RPC Gateway sessions.compact et nécessite un gateway en cours d’exécution.

openclaw sessions compact "agent:main:main"openclaw sessions compact "agent:main:main" --max-lines 200openclaw sessions compact "agent:work:main" --agent work --json

• Sans --max-lines, le LLM du gateway résume la transcription. Cela peut être lent, donc la valeur par défaut de --timeout est 180000 ms.
• Avec --max-lines <n>, la commande tronque aux n dernières lignes de transcription et archive la transcription précédente comme sidecar .bak.
• --agent <id> : agent propriétaire de la session ; requis pour les clés global.
• --url / --token / --password : remplacements de connexion au gateway.
• --timeout <ms> : délai d’expiration RPC en millisecondes.
• --json : imprimer la charge utile RPC brute.

La commande se termine avec un code non nul lorsque le gateway signale une Compaction échouée ou est injoignable, afin que les crons et scripts ne prennent jamais une absence d’opération silencieuse pour une réussite.

Remarque : openclaw agent --message '/compact ...' n’est pas un chemin de Compaction. Les commandes slash depuis la CLI sont rejetées par la vérification d’expéditeur autorisé ; cette invocation se termine avec un code non nul et des indications pointant ici au lieu de ne rien faire silencieusement.

RPC sessions.compact

openclaw gateway call sessions.compact --params '<json>' accepte :

Exemple de réponse de synthèse LLM :

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "result": { "tokensBefore": 243868, "tokensAfter": 34941 }}

Exemple de réponse de troncature (--max-lines 200) :

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",  "kept": 200}

Connexe

• Configuration de session : Référence de configuration
• Référence CLI
• Gestion des sessions