第07篇-Session模型与记忆

【OpenClaw 从入门到精通】第 7 篇Session 模型与记忆本系列定位零基础入门从安装配置到高级架构全覆盖。无论你是开发者、运维工程师、还是技术爱好者本系列带你彻底掌握 OpenClaw。本篇你将学到OpenClaw 的 Session 概念main vs 非 main会话管理工具记忆系统AGENTS.md / SOUL.md上下文压缩学完本篇你将理解 OpenClaw 如何管理对话上下文和持久记忆。一、Session 模型1.1 main 会话 vs 非 main 会话OpenClaw 有两种会话类型类型说明工具权限main你直接使用的默认会话全部工具完全信任非 main群组/其他用户/其他通道的会话受沙箱限制1.2 每个通道的 Session你的 Telegram 私聊 → main 会话或指定会话 Discord 群组 A → 非主会话 1沙箱内 Discord 群组 B → 非主会话 2沙箱内 Slack DM → main 会话或指定会话1.3 Session 工具工具作用sessions_list列出所有活跃会话sessions_history查看某个会话的历史sessions_send向另一个会话发送消息下面是 Session 模型的整体架构图Telegram 私聊Discord 群组 ADiscord 群组 BSlack DM用户输入通道类型main 会话非主会话 1沙箱非主会话 2沙箱main 会话全部工具权限受沙箱限制二、会话管理2.1 基本命令# 查看会话openclaw sessions list# 查看历史openclaw sessionshistorySESSION_ID2.2 Chat 命令/new ← 新建会话 /reset ← 重置会话 /status ← 查看当前会话状态 /compact ← 压缩上下文2.3 会话间通信Agent 可以通过sessions_send向其他会话发送消息你告诉 Slack 频道 #dev部署已完成 OpenClaw sessions_send: target#dev message部署已完成 ✅ ✅ 消息已发送到 #dev三、记忆系统3.1 AGENTS.md — 项目上下文位于 Workspace 根目录每次对话自动注入# 项目说明 ## 技术栈 Node.js 24 TypeScript Express ## 规范 - 使用 ESM 模块 - 测试用 Vitest - 提交前运行 lint3.2 SOUL.md — Agent 人格定义 Agent 的行为风格# 人格 - 回答简洁直接 - 中文交流 - 代码注释用中文 - 不确定时先问3.3 记忆注入机制System Prompt 基础指令 工具定义 AGENTS.md SOUL.md 对话历史 ↑ ↑ 项目上下文 Agent 人格下面是记忆系统的注入流程基础指令System Prompt工具定义AGENTS.md项目上下文SOUL.mdAgent 人格对话历史Agent 响应四、上下文压缩4.1 自动压缩当对话接近模型上下文窗口限制时OpenClaw 自动压缩对话 token 数 阈值 → 自动总结早期对话 → 压缩上下文 → 继续对话4.2 手动压缩/compact ✅ Context compressed: 45,000 → 8,200 tokens (82% reduction)下面是上下文压缩的决策流程否是自动手动对话进行中Token 数 阈值继续正常对话压缩方式自动总结早期对话用户输入 /compact压缩上下文Token 数大幅减少本篇小结知识点核心内容main 会话默认会话全部工具权限非 main 会话群组/多用户沙箱限制sessions_list/history/send会话管理工具AGENTS.md项目级上下文注入SOUL.mdAgent 人格定义/compact手动压缩上下文自动压缩接近窗口限制时触发下篇预告第 8 篇Workspace 与上下文文件如果本篇内容对你有帮助欢迎点赞收藏有任何疑问欢迎在评论区交流。