Sessions

text

Copy

openclaw sessions

List stored conversation sessions.

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

Scope selection:

• default: configured default agent store
• text

  Copy

  --verbose
  : verbose logging
• text

  Copy

  --agent <id>
  : one configured agent store
• text

  Copy

  --all-agents
  : aggregate all configured agent stores
• text

  Copy

  --store <path>
  : explicit store path (cannot be combined with
  text

  Copy

  --agent
  or
  text

  Copy

  --all-agents
  )

Export a trajectory bundle for a stored session:

bash
Copy
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

This is the command path used by the

slash command after the owner approves the exec request. The output directory is always resolved inside under the selected workspace.

reads configured agent stores. Gateway and ACP session discovery are broader: they also include disk-only stores found under the default root or a templated root. Those discovered stores must resolve to regular files inside the agent root; symlinks and out-of-root paths are skipped.

JSON examples:

:

json
Copy
{
  "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" }
  ]
}

Cleanup maintenance

Run maintenance now (instead of waiting for the next write cycle):

bash
Copy
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

uses settings from config:

• Scope note:

  text

  Copy

  openclaw sessions cleanup
  maintains session stores, transcripts, and trajectory sidecars. It does not prune cron run logs (
  text

  Copy

  cron/runs/<jobId>.jsonl
  ), which are managed by
  text

  Copy

  cron.runLog.maxBytes
  and
  text

  Copy

  cron.runLog.keepLines
  in Cron configuration and explained in Cron maintenance.

• text

  Copy

  --dry-run
  : preview how many entries would be pruned/capped without writing.
  • In text mode, dry-run prints a per-session action table (
    text

    Copy

    Action
    ,
    text

    Copy

    Key
    ,
    text

    Copy

    Age
    ,
    text

    Copy

    Model
    ,
    text

    Copy

    Flags
    ) so you can see what would be kept vs removed.

• text

  Copy

  --enforce
  : apply maintenance even when
  text

  Copy

  session.maintenance.mode
  is
  text

  Copy

  warn
  .

• text

  Copy

  --fix-missing
  : remove entries whose transcript files are missing, even if they would not normally age/count out yet.

• text

  Copy

  --active-key <key>
  : protect a specific active key from disk-budget eviction.

• text

  Copy

  --agent <id>
  : run cleanup for one configured agent store.

• text

  Copy

  --all-agents
  : run cleanup for all configured agent stores.

• text

  Copy

  --store <path>
  : run against a specific
  text

  Copy

  sessions.json
  file.

• text

  Copy

  --json
  : print a JSON summary. With
  text

  Copy

  --all-agents
  , output includes one summary per store.

:

json
Copy
{
  "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
    }
  ]
}

Related:

• Session config: Configuration reference

Related

• CLI reference
• Session management