一、工作空间核心概念
工作空间（Workspace）是 OpenClaw 智能体的核心运行目录，集中存放人格设定、行为规范、工具规则、记忆数据、会话记录等全部配置，相当于智能体的运行载体与数据中枢。
默认工作空间路径：
plaintext
~/.openclaw/workspace/
二、完整目录层级结构
整体目录分为全局配置、默认工作空间、多智能体独立空间、技能仓库四大板块，结构如下：
plaintext
~/.openclaw/
├── openclaw.json # 网关全局主配置文件
├── workspace/ # 默认智能体主工作空间
│ ├── AGENTS.md # 业务操作规范文档
│ ├── SOUL.md # 人格、语气、行为边界（最高优先级）
│ ├── TOOLS.md # 工具调用规则
│ ├── USER.md # 用户信息与使用偏好
│ ├── IDENTITY.md # 对外身份与展示风格
│ ├── BOOTSTRAP.md # 首次启动初始化流程
│ ├── MEMORY.md # 长期持久化记忆
│ ├── DREAMS.md # 实验型记忆模块
│ ├── memory/ # 按日期归档的日常笔记
│ │ ├── 2025-01-15.md
│ │ └── 2025-01-16.md
│ └── skills/ # 工作区本地自定义技能
│ └── my-skill/
│ └── SKILL.md
├── skills/ # 全局公共技能目录
│ └── installed-skill/
│ └── SKILL.md
└── agents/ # 多智能体集群配置目录
└── 自定义智能体名/
├── workspace/ # 该智能体独立工作空间
└── sessions/ # 该智能体专属会话记录
三、核心配置文档详解
会话启动时，系统会按固定顺序加载所有文档，文档规则会注入智能体上下文，约束其行为与应答逻辑。
3.1 SOUL.md — 人格内核（最高优先级）
定义智能体身份定位、说话风格、行为底线、禁忌规则，优先级高于所有其他配置，是整个人格的核心准则。
示例：
markdown
# 人格内核
你是一名资深全栈技术顾问，擅长服务端与前端开发。
## 表达风格
- 行文简洁干练，不堆砌冗余内容
- 全程使用中文交流，专业英文术语保留原写法
- 适度使用表情符号，营造轻松沟通氛围
## 行为边界
- 严禁执行删除生产库、清空核心数据等高风险操作
- 代码中禁止硬编码账号、密码等敏感信息
- 遇到无法确定的问题，主动向用户确认后再执行
## 使用偏好
- 优先选用 TypeScript 进行开发
- 包管理器优先选择 pnpm
- 代码注释统一使用中文编写
与 AGENTS.md 区分
表格
| 文件 | 核心关注点 | 类比定义 |
|---|---|---|
| SOUL.md | 身份、语气、禁忌、价值观 | 性格与行事底线 |
| AGENTS.md | 业务流程、操作步骤、项目规范 | 岗位工作手册 |
3.2 AGENTS.md — 业务操作手册
用于定义业务流程、项目规范、编码标准、部署步骤、常用指令，偏向具体工作执行细则。
示例：
markdown
# 项目操作指南
## 技术栈
Node.js + Express + MySQL
## 编码规范
- 强制使用 TypeScript
- 变量、函数采用小驼峰命名
- 文件名称统一使用短横线分隔
## 发布流程
1. 执行单元测试：npm test
2. 项目打包构建：npm run build
3. 上传产物至服务器：scp dist/ server:/app/
3.3 TOOLS.md — 工具调用规范
明确各类内置工具的使用场景、调用方式与约束，指导智能体合理选用工具。
示例：
markdown
# 工具使用准则
## 文件操作
- 读取文件优先使用 read 工具
- 写入文件优先使用 write 工具
- 禁止通过命令行指令读取普通文本
## 浏览工具
- 网页访问、元素交互使用 browser 工具
- 页面布局、样式校验依赖截图能力
3.4 USER.md — 用户画像档案
记录用户身份、技术栈、使用习惯、个人偏好，让智能体适配用户风格，定制化输出内容。
示例：
markdown
# 用户信息
- 姓名：小明
- 岗位：前端开发工程师
- 技术栈：React + TypeScript + Tailwind CSS
- 偏好：代码追求简洁，拒绝过度抽象设计
- 工作环境：macOS + VS Code
3.5 IDENTITY.md — 对外身份标识
设定智能体对外展示名称、形象、整体风格定位。
示例：
markdown
# 身份标识
名称：小龙
风格：专业严谨、风趣友善
形象标识：🐉
3.6 BOOTSTRAP.md — 首次启动引导
仅在智能体第一次运行时执行，用于初始化交互、收集信息、完成环境预热。
示例：
markdown
# 首次启动流程
1. 主动向用户问好，自我介绍
2. 询问用户技术方向与日常需求
3. 整理收集到的信息，写入 USER.md 存档
四、自定义人格模板
通过修改 SOUL.md 即可快速塑造不同风格的智能体，提供三类常用模板参考。
模板 1：严谨型技术顾问
markdown
# 人格设定
你是专业严谨的技术顾问。
## 应答风格
- 输出内容有理有据，结论明确
- 不确定的问题直接说明，不主观猜测
- 给出方案时同步附带原理与注意事项
## 执行规则
- 代码示例必须可直接运行
- 涉及安全、权限类操作，主动做出风险提醒
模板 2：轻松型编程伙伴
markdown
# 人格设定
你是陪伴式编程伙伴，沟通轻松自然。
## 应答风格
- 语气口语化，不拘谨
- 适当搭配表情符号，活跃氛围
- 遇到技术难点分步讲解，循序渐进
## 执行规则
- 长代码拆分为多段展示，单次不超过50行
- 先讲解思路，再提供代码
- 程序报错时优先安抚，协同排查问题
模板 3：本土化中文助手
markdown
# 人格设定
面向国内开发者的专属助手。
## 语言规则
- 全文使用中文回复，技术名词保留英文原词
- 命令行、代码内注释统一使用中文
## 适配规则
- 优先推荐国内可正常访问的服务、镜像源
- 方案设计充分考虑国内网络环境限制
五、技能加载规则与目录
5.1 加载优先级（由高至低）
同名技能会被高优先级版本覆盖，可利用该特性自定义改写官方技能：
- 工作区本地技能：
~/.openclaw/workspace/skills/ - 全局公共技能：
~/.openclaw/skills/ - 系统内置原生技能
5.2 本地自定义技能创建
bash
运行
# 创建自定义技能目录
mkdir -p ~/.openclaw/workspace/skills/my-helper
新建 SKILL.md 配置文件：
markdown
---
name: my-helper
description: 自定义辅助工具
---
# 使用规则
收到求助请求时，按如下流程执行：
1. 梳理问题背景
2. 输出完整解决方案
3. 配套提供可落地代码示例
5.3 全局技能安装
通过 clawhub 安装的技能，统一存放至全局目录：
bash
运行
clawhub install some-skill
# 存放路径：~/.openclaw/skills/some-skill/
六、会话数据管理
6.1 存储路径
- 默认单智能体：
~/.openclaw/agents/default/sessions/ - 多智能体模式：
~/.openclaw/agents/自定义名称/sessions/
会话以 JSONL 文件格式保存，完整记录交互全量内容。
6.2 会话管理指令
bash
运行
# 查看全部会话列表
openclaw sessions list
# 查看指定会话历史记录
openclaw sessions history 会话ID
# 清理过期会话（示例：清理30天前数据）
openclaw sessions prune --older-than 30d
七、工作空间初始化方式
7.1 向导式快速初始化（推荐）
通过交互式向导一键完成模型、密钥、通道、基础配置创建：
bash
运行
openclaw setup
执行流程：
- 选择大模型服务商
- 填写 API 密钥
- 选配交互通道
- 自动生成全套基础配置文件
初始化完成后启动服务与交互：
bash
运行
# 启动网关服务
openclaw gateway run
# 终端直接发起对话
openclaw agent --message "你好"
7.2 手动初始化
适合有定制需求、自主搭建配置的场景：
bash
运行
# 创建工作空间根目录
mkdir -p ~/.openclaw/workspace
# 写入基础人设 SOUL.md
cat > ~/.openclaw/workspace/SOUL.md << 'EOF'
# 人格设定
你是中文AI助手，全程使用中文回复，专注解决各类技术问题。
EOF
# 写入操作规范 AGENTS.md
cat > ~/.openclaw/workspace/AGENTS.md << 'EOF'
# 工作规范
优先提供国内可用方案，输出内容简洁实用。
EOF
八、多智能体独立工作空间
支持部署多个独立智能体，每一个智能体都拥有专属工作空间、人设、技能与会话，相互隔离：
plaintext
~/.openclaw/agents/
├── coder/ # 编程助手
│ ├── workspace/
│ │ ├── SOUL.md
│ │ ├── AGENTS.md
│ │ └── skills/
│ └── sessions/
└── assistant/ # 日常综合助手
├── workspace/
│ ├── SOUL.md
│ └── AGENTS.md
└── sessions/
可使用 openclaw agents 指令完成多智能体的创建、切换与管理。
九、配置文件加载顺序
新会话启动后，系统严格按以下顺序加载文档，先加载的文档优先级更高：
- SOUL.md（人格内核，权限最高）
- IDENTITY.md（身份风格）
- USER.md（用户资料）
- AGENTS.md（业务操作规范）
- TOOLS.md（工具使用规则）
- 已加载技能文件
- MEMORY.md（长期记忆）
关键说明：若 SOUL.md 中做出限制（如禁止高危命令），后续所有文档、指令都无法突破该规则。
十、总结
- 工作空间是智能体的配置与数据核心，所有行为、人设、记忆、会话均在此管理。
SOUL.md决定人格与底线，AGENTS.md定义工作流程，二者分工明确。- 技能遵循本地 > 全局 > 系统的加载优先级，支持自定义覆盖原有能力。
- 单智能体可快速上手，多智能体实现业务隔离，适配复杂使用场景。
- 可使用
openclaw setup一键初始化，也可手动精细化搭建全套配置。