一文精通 OpenClaw 数据架构

Gateway 负责入口和路由
Agent 是独立大脑
Workspace 保存长期文件和记忆
AgentDir 保存运行时状态
Session 保存对话线
Context 是单次推理快照
Delivery Route 决定消息发往哪里

OpenClaw 的整体层级：

Gateway
— Agent
—— Workspace
—— Session
——— Session Key
——— Context
——— Delivery Route
—— AgentDir

Gateway 是统一入口和调度中心。所有渠道，比如 微信、飞书、钉钉，以及 CLI、WebChat 等客户端。
Gateway 负责接收消息、匹配路由规则、分发给对应 Agent，再把结果送回指定渠道。

Agent 是独立的大脑单元。
每个 Agent 都有自己的 Workspace、AgentDir、Session Store、记忆和配置。
比如可以有 main、work、family 三个 Agent，分别处理私人、工作、家庭场景，彼此隔离。

Workspace 是 Agent 的文件系统家目录，可以理解为“硬盘”。
它保存人设、行为规范、用户信息、长期记忆、每日记忆和技能包，例如 AGENTS.md、SOUL.md、USER.md、MEMORY.md、memory/YYYY-MM-DD.md、skills/ 等。

AgentDir 是 Agent 的运行时状态目录，通常在 ~/.openclaw/agents/<agentId>/。
它保存认证信息、模型配置、Codex 运行时状态和 session 对话记录，不建议放进版本控制。

Session 是 Agent 内部的一条对话线，可以按渠道、联系人、群组、任务或定时任务隔离。
Session 保存完整对话历史，但可以按天、空闲时间或手动 /reset 重置。

Session Key 用来标识具体会话线，格式类似：
agent:<agentId>:<mainKey>

Memory 是跨 Session 的持久记忆层。Session 重置后，对话历史会清空，但 Memory 仍然保留，并可以在新 session 中重新注入上下文。

Context 是每次模型推理时真正看到的内容快照。
它不等于完整 Session 历史，而是由 system prompt、workspace 文件注入、近期对话、工具调用结果和附件组成。
历史太长时会通过 compaction 压缩。

Delivery Route 决定回复发往哪个渠道。
它和 Session 是解耦的，所以可以在 Telegram 开始任务，然后把后续回复 dock 到 Discord，而不重置原来的 Session。

多 Agent 配置
默认只有 main，多 Agent 时可以在 ~/.openclaw/openclaw.json 里为每个 Agent 指定独立 workspace。