nyrn
/
openclaw
mirror of https://github.com/openclaw/openclaw.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
openclaw/docs/cli/sessions.md

1.3 KiB
Raw Blame History

summary read_when title
CLI reference for `openclaw sessions` (list stored sessions + usage)
You want to list stored sessions and see recent activity
sessions

openclaw sessions

List stored conversation sessions.

openclaw sessions
openclaw sessions --active 120
openclaw sessions --json

Cleanup maintenance

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

openclaw sessions cleanup --dry-run
openclaw sessions cleanup --enforce
openclaw sessions cleanup --enforce --active-key "agent:main:telegram:dm:123"
openclaw sessions cleanup --json

openclaw sessions cleanup uses session.maintenance settings from config:

  • --dry-run: preview how many entries would be pruned/capped without writing.
  • --enforce: apply maintenance even when session.maintenance.mode is warn.
  • --active-key <key>: protect a specific active key from disk-budget eviction.
  • --store <path>: run against a specific sessions.json file.
  • --json: print one JSON summary object. Dry-run output includes projected diskBudget impact (totalBytesBefore/After, removedFiles, removedEntries) when disk budgeting is enabled.

Related: