AI-Wiki

基本定义

OpenClaw单Agent存储结构是OpenClaw框架中每个独立智能体对应的磁盘存储规范，是OpenClaw多Agent协作机制的基础构成单元。每个Agent对应三类职责完全隔离的存储目录，从身份定义、运行环境、会话记录三个维度完整承载单Agent的全部属性，无需依赖全局共享存储即可独立运行。

核心存储组成

每个Agent的存储体系由三类目录构成，各自职责、存储内容、使用规则完全独立：

1. workspace目录

该目录决定Agent的身份与核心能力，存储所有与工作内容相关的配置，包含三类核心内容：

SOUL.md：定义Agent的角色定位、人设、输出规范、任务目标等身份属性，例如“你是专业的SEO专家，输出要专业但避免晦涩术语”；
TOOLS.md：定义Agent可调用的工具清单、调用权限、使用规则，例如是否允许调用搜索工具、文件读写工具等；
memory/：存储Agent的持久化上下文记忆，用于保留历史工作经验。默认存储路径为~/.openclaw/workspace或~/.openclaw/workspace-*，支持自定义存储位置，只要在核心配置文件openclaw.json中登记正确路径即可生效。agency-agents本质就是官方或社区预打包的标准化workspace模板集合。

2. agentDir目录

该目录为Agent的运行基础环境配置，存储系统层面的非业务属性参数，包含模型选型配置、API认证信息、运行状态缓存等内容，相当于Agent的“系统档案”。用户不需要频繁修改该目录内容，但目录必须存在才能正常启动Agent，默认存储路径为~/.openclaw/agents/{Agent唯一ID}/agent。

3. sessions目录

该目录存储该Agent的独立对话记录，所有会话历史与其他Agent完全隔离，避免不同Agent的上下文互相污染，相当于每个Agent专属的“工作日志”。例如主Agent与SEO专家Agent的对话历史完全分开，不会在会话中互相串扰，是多Agent协作场景下保障上下文准确性的核心机制。

边界与注意事项

存储目录的有效性以OpenClaw核心配置文件openclaw.json中的登记信息为准，仅磁盘存在对应目录但未在配置中注册的，不会被识别为有效Agent的存储结构；
workspace与agentDir职责严格区分，可记忆口诀“办公桌上放文件（workspace存业务配置），档案柜里放工卡（agentDir存系统配置）”，避免修改错误导致Agent身份或运行异常；
sessions目录的隔离性为强制规则，无法通过配置关闭，可满足多Agent任务拆分原则中“按产出物拆任务”的上下文隔离要求。