会话管理
会话是你与 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 小时的会话会自动从内存中移除,防止无限增长。磁盘上的会话文件不会被删除——需要时仍可附加恢复。