Skip to content

会话(Sessions)

会话(Session) 是 OpenClaw 跟踪每段对话历史的方式。每当你通过聊天软件和 AI 说话,这段对话就保存在一个会话里。


会话是什么?

用生活来打比方:会话就像手机聊天 App 里的"单个聊天窗口"。

  • 你在 Telegram 里给 AI 发消息 → 一个会话
  • 你的朋友通过同一个 Bot 发消息 → 另一个独立会话
  • AI 记得你们在同一个会话里说过的话,但不同会话之间互不干扰

每个会话有自己独立的"记忆",就像你和不同朋友有不同的聊天记录。


会话保存在哪里?

会话记录存在你的电脑上:

~/.openclaw/agents/<agentId>/sessions/

每个会话是一个 .jsonl 文件,记录了所有对话轮次(用户消息 + AI 回复)。


会话的关键概念

概念说明
会话 Key唯一标识一段对话,格式如 agent:main:telegram:dm:123456
会话范围(Scope)控制会话是私人的还是共享的
会话压缩(Compaction)对话太长时,自动压缩旧内容节省 Token

会话什么时候会结束?

默认情况下,会话不会自动结束。AI 会一直记得你们的对话,直到:

  • 手动清除会话历史
  • 会话被压缩(超过上下文长度限制时自动发生)
  • 你在配置里设置了会话超时

相关文档

用工程视角拆解 AI 智能体框架