Cli 导读

查会话、清缓存,一条命令搞定

`openclaw sessions` 列出所有存储的对话会话,支持按 agent、全部 agent 或自定义路径筛选。`cleanup` 子命令按配置的维护策略清理过期会话,先用 `--dry-run` 预览再 `--enforce` 执行,注意它只管会话,不管 cron 运行日志。

先讲这一页到底在解决什么

查会话、清缓存,一条命令搞定

`openclaw sessions` 列出所有存储的对话会话,支持按 agent、全部 agent 或自定义路径筛选。`cleanup` 子命令按配置的维护策略清理过期会话,先用 `--dry-run` 预览再 `--enforce` 执行,注意它只管会话,不管 cron 运行日志。

原文共 3 节,先看 Start Here 路径:/cli/sessions 查看官方原文

第一站

🪟 先看最常见的四种开抽屉方式

官方例子很直接:单个 agent、所有 agent、最近活跃的、或者直接看 JSON。

🧑

openclaw sessions

像默认翻当前这个工位的抽屉。

👷

--agent work

像只看 work 这个桌子的抽屉。

🏷

--all-agents

像把所有桌子的抽屉都翻出来,摆成一排看。

🕒

--active 120

像只看最近两小时还热着的抽屉。

第二站

🏠 agent store 像“每张桌子自己的文件夹”

sessions 不只在一个大柜子里。它们可以按 agent 分开存,也可以从更大的范围里找出来。

📁 默认 store

像当前桌子的默认文件夹,最常见,也最容易先看。

--store <path>

像你自己指定一个更远的文件夹,不走默认路线。

--all-agents

像把所有工位的文件夹都拿出来,不漏一个。

⭐ 一句话

session 的位置可以很分散,但它们都还是小抽屉。

第三站

🔍 `--active` 像“只看最近还热着的聊天页”

这个参数特别适合排查:你不想翻几百页,只想看最近还在动的那几个 session。

🔥

最近活跃

像只看刚刚有人坐过、椅子还是热的抽屉。

🧊

没那么活跃的

像已经凉下来的旧抽屉,必要时再翻。

📌

很适合排障

先看热的抽屉,常常能最快找到刚刚发生了什么。

🎈

一句话

active 是帮你缩小抽屉范围,不用整柜乱翻。

第四站

🧹 `cleanup` 像“整理抽屉,不是删故事本身”

官方给 sessions 还配了维护动作。它不是发消息,而是帮你清理、裁剪、收拾存档。

openclaw sessions cleanup --dry-run

像先拿着扫帚比划一下,不真的扔东西。

--enforce

像说“这次别只提醒,真的照着收拾”。

--active-key

像先保护一张你正在用的抽屉卡,别把它误收走。

🎈 一句话

cleanup 是整理仓库,不是抹掉故事。

第五站

🧾 JSON 输出像“把抽屉目录变成机器能数的表格”

如果你不是人眼看,而是要给脚本或别的工具读,JSON 就很合适。

🧮

--json

像把抽屉名单改成一张整齐的统计表。

📚

sessions 不是聊天本

它更像仓库索引。真正聊天内容在抽屉里,它负责告诉你抽屉在哪里、还有几格。

📌

机器读起来更稳

JSON 让工具更容易自动判断要不要清理、要不要保留。

🎈

一句话

要给机器看时,JSON 比人话更整齐。

最后总结

🎈 把 openclaw sessions 压成一句话

openclaw sessions 就是翻会话抽屉的命令:看哪一柜、哪一格、哪一个最近还热着,再决定要不要清理或整理。