docs/docs/fr/cli/sessions.md

read_when	summary	title	x-i18n
Vous voulez lister les sessions enregistrées et consulter l’activité récente	Référence de la CLI pour `openclaw sessions` (liste des sessions enregistrées + utilisation)	Sessions	generated_at model provider source_hash source_path workflow 2026-05-02T07:02:58Z gpt-5.5 openai 9c7f0d521756ace4af05451b925256f89661bf971533541764c128e2be9d6431 cli/sessions.md 16

openclaw sessions

Lister les sessions de conversation stockées.

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

openclaw sessions
openclaw sessions --agent work
openclaw sessions --all-agents
openclaw sessions --active 120
openclaw sessions --verbose
openclaw sessions --json

Sélection du périmètre :

• par défaut : stockage de l’agent par défaut configuré
• --verbose : journalisation détaillée
• --agent <id> : un stockage d’agent configuré
• --all-agents : agréger tous les stockages d’agents configurés
• --store <path> : chemin de stockage explicite (ne peut pas être combiné avec --agent ou --all-agents)

Exporter un bundle 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 l’approbation de la demande d’exécution par le propriétaire. 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 stockages d’agents configurés. La découverte des sessions Gateway et ACP est plus large : elle inclut aussi les stockages uniquement présents sur disque trouvés sous la racine agents/ par défaut ou sous une racine session.store basée sur un modèle. Ces stockages 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,
  "activeMinutes": null,
  "sessions": [
    { "agentId": "main", "key": "agent:main:main", "model": "gpt-5" },
    { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" }
  ]
}

Maintenance du nettoyage

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

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

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

• Note de périmètre : openclaw sessions cleanup maintient les stockages de sessions, les transcriptions et les fichiers annexes de trajectoire. Elle ne supprime pas les journaux d’exécution Cron (cron/runs/<jobId>.jsonl), qui sont gérés par cron.runLog.maxBytes et cron.runLog.keepLines dans la configuration Cron et expliqués dans la maintenance Cron.

• --dry-run : prévisualiser le nombre d’entrées qui seraient supprimées ou plafonnées sans écriture.

  • En mode texte, l’exécution à blanc imprime un tableau d’actions par session (Action, Key, Age, Model, Flags) pour que vous puissiez 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, même si elles ne seraient normalement pas encore exclues par l’âge ou le nombre.

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

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

• --all-agents : exécuter le nettoyage pour tous les stockages 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 stockage.

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,
      "pruned": 40,
      "capped": 0
    },
    {
      "agentId": "work",
      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",
      "beforeCount": 18,
      "afterCount": 18,
      "pruned": 0,
      "capped": 0
    }
  ]
}

Connexe :

• Configuration des sessions : Référence de configuration

Connexe

• Référence CLI
• Gestion des sessions