nexus/wiki/concepts/Workspace.md

title, type, tags, sources, last_updated

title	type	tags	sources	last_updated
Workspace	concept	OpenClaw Agent Configuration	万字讲透openclaw-workspace深度解析-2026-03-21	2026-03-21

Definition

Workspace 是 OpenClaw 中 Agent 的工作台目录（默认 ~/.openclaw/workspace/），包含一系列 Markdown 配置文件，决定 Agent 怎么工作、什么性格、记住什么。

目录结构

~/.openclaw/
├── workspace/               # 默认情况下主 Agent 的工作区
│   ├── AGENTS.md           # Agent 的行为规则与多 Agent 协调
│   ├── SOUL.md             # Agent 的叙事性格设定
│   ├── USER.md             # 用户画像与偏好
│   ├── IDENTITY.md         # Agent 身份元数据（名字/emoji/头像）
│   ├── TOOLS.md            # 工具权限声明与使用规范
│   ├── HEARTBEAT.md        # 会话节奏/状态提示
│   ├── BOOTSTRAP.md        # 首次启动引导（完成后应删除）
│   ├── MEMORY.md           # 长期知识总表
│   ├── memory/             # 按日期滚动的记忆笔记
│   └── skills/             # 技能包目录
├── agents/<agentId>/       # 各 Agent 的运行态目录
└── openclaw.json           # 总控配置

核心洞察

OpenClaw 使用者存在一条隐形分界线：

• 不会用 workspace 的人：每次都要重新交代背景，Agent 每次都像陌生人
• 会用 workspace 的人：Agent 知道用户是谁、该怎么说话、记得上次积累的东西

这条分界线，就是 workspace。

与 agentDir / sessions 的区别

概念	职责
workspace	Agent 的工作台，决定"怎么工作"
agentDir	openclaw.json 里的配置字段，指向运行状态目录
sessions	对话历史日志

Related Concepts

• AGENTS.md — workspace 核心文件之一
• SOUL.md — workspace 核心文件之一
• USER.md — workspace 核心文件之一
• IDENTITY.md — workspace 核心文件之一
• TOOLS.md — workspace 核心文件之一
• Agent-Memory — workspace 中的长期记忆机制
• OpenClaw — Workspace 所属的框架