概述
openclaw sessions 列出已存储的对话会话。显示的是持久化的会话行，不是渠道连接的实时探测。
openclaw sessions [--agent <id>] [--all-agents] [--active <minutes>] [--limit <n|all>] [--verbose] [--json]
openclaw sessions cleanup [options]
openclaw sessions export-trajectory --session-key <key> --workspace <dir>需要实时渠道连接状态时，用
openclaw channels status --probe、openclaw status --deep或openclaw health --verbose。
列表选项
| 选项 | 说明 |
|---|---|
--agent <id> | 指定单个 agent 的 session store |
--all-agents | 聚合所有配置的 agent store |
--store <path> | 显式指定 store 文件路径（不能与 --agent/--all-agents 同用） |
--active <minutes> | 仅显示最近 N 分钟内活跃的会话 |
--limit <n|all> | 最大返回行数（默认 100；all 返回全部） |
--verbose | 详细日志 |
--json | JSON 输出，含 totalCount、limitApplied、hasMore |
默认作用域：配置的默认 agent store。
导出轨迹
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输出目录固定在所选工作区的 .openclaw/trajectory-exports/ 下。这是 /export-trajectory slash 命令的底层路径。
清理维护
openclaw sessions cleanup --dry-run # 预览，不写入
openclaw sessions cleanup --enforce # 强制执行（即使 mode=warn）
openclaw sessions cleanup --agent work --dry-run
openclaw sessions cleanup --all-agents --dry-run
openclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"
openclaw sessions cleanup --dry-run --fix-dm-scope
openclaw sessions cleanup --json清理范围：session store、transcript、trajectory sidecar。不清理 cron 运行日志（由 cron.runLog.* 管理）。
| 选项 | 说明 |
|---|---|
--dry-run | 预览将被清理的条目（文本模式输出 Action/Key/Age/Model/Flags 表格） |
--enforce | 即使 session.maintenance.mode=warn 也强制执行 |
--fix-missing | 移除 transcript 文件缺失的条目 |
--fix-dm-scope | 当 session.dmScope=main 时，清理旧的 per-peer DM 行（先用 --dry-run 确认） |
--active-key <key> | 保护指定活跃 key 不被磁盘预算驱逐 |
--agent <id> | 仅清理指定 agent store |
--all-agents | 清理所有配置的 agent store |
--store <path> | 直接操作指定 sessions.json 文件（离线修复） |
Gateway 可达时，非 dry-run 清理通过 Gateway 执行（与运行时流量共享同一写入者）。
相关页面
- session — 会话路由与生命周期
- session-pruning — 工具结果裁剪与 cache TTL