会话管理

会话是你与 Agent 之间的持久对话上下文。会话保存完整的消息历史、已完成任务数和费用统计,随时可以从上次中断的地方继续。

终端会话

新建会话

运行 openclacky 始终在当前目录创建新会话:

openclacky
openclacky --path /path/to/project

查看会话列表

openclacky -l

显示当前目录的最近会话,包括名称、任务数和创建时间。会话按编号显示,方便直接附加。

继续上次会话

clacky -c

恢复当前目录最近的会话,还原完整的对话历史。

附加到指定会话

# 通过列表编号
clacky -a 2

# 通过会话 ID 前缀
clacky -a b6682a87

Web UI 会话

openclacky server 模式下,通过浏览器界面管理会话:

  • 新建 — 点击左侧边栏的"新建会话"
  • 切换 — 点击侧边栏中的任意会话
  • 重命名 — 点击会话名称直接编辑
  • 删除 — 删除不再需要的会话

服务器启动时自动还原每个工作目录最近的 5 个会话,会话在服务器重启后依然保留。


会话持久化

会话保存在 ~/.clacky/sessions/ 目录下。每个会话文件存储:

  • 会话 ID 和名称
  • 工作目录
  • 完整消息历史(用户消息、助手回复、工具调用)
  • 任务数和累计费用
  • 时间戳

会话文件以会话 ID 命名,永久保存,除非手动删除。


会话隔离

每个会话完全独立:

  • 独立的对话历史
  • 独立的工作目录(可以相同也可以不同)
  • 独立的任务上下文——一个会话中的 Agent 不知道另一个会话的存在
  • 独立的权限模式(仅 CLI)

非活跃会话清理

在服务器模式下,空闲超过 24 小时的会话会自动从内存中移除,防止无限增长。磁盘上的会话文件不会被删除——需要时仍可附加恢复。