2.8 KiB
2.8 KiB
title, type, tags, date
| title | type | tags | date | |||||
|---|---|---|---|---|---|---|---|---|
| 万字讲透OpenClaw-Workspace深度解析 | source |
|
2026-03-21 |
Source File
Summary
- 核心主题：OpenClaw workspace 文件体系深度解析
- 问题域：AI Agent 个性化配置与长期记忆
- 方法/机制：workspace 目录结构、各文件职责（AGENTS.md、SOUL.md、USER.md、IDENTITY.md、TOOLS.md、BOOTSTRAP.md、memory/）
- 结论/价值：workspace 是让 Agent 从"能工作"变成"好用"的关键，通过固化用户偏好、Agent 性格和长期记忆实现个性化
Key Claims
- workspace 是 OpenClaw 中决定 Agent 如何工作的核心文件体系
- AGENTS.md 是岗位说明书，SOUL.md 是性格档案，两者分工明确不应混写
- USER.md 作用是固化用户偏好，减少重复交代
- TOOLS.md 规范工具使用，减少误操作
- BOOTSTRAP.md 是一次性引导，完成初始化后应删除
- memory/ 目录是 Agent 的长期记忆机制
Key Quotes
"workspace 是 Agent 的'工作台'（决定怎么工作），agentDir 是 openclaw.json 里的一个配置字段（指向存放运行状态的目录），sessions 是'工作日志'（记对话历史）。三者职责不同，不要混为一谈。" "一个没有 SOUL.md 的 Agent，每次对话都像第一次见面——它不记得自己是谁，说话没有固定风格，遇到同样的问题今天这么说、明天那么说。" "300-500 字的 AGENTS.md，比 2000 字的更有效。" "SOUL.md 是新来的助理的个人简历，USER.md 是 HR 给这位助理写的'关于你的上司，你需要提前知道的事'。"
Key Concepts
- Workspace：OpenClaw 中 Agent 的工作台目录，包含行为规则、性格设定、用户偏好等配置文件
- AGENTS.md：Agent 的行为规则与多 Agent 协调文件，相当于岗位说明书
- SOUL.md：Agent 的叙事性格设定文件，相当于人物小传
- USER.md：用户画像与偏好固化文件
- IDENTITY.md：Agent 的结构化身份元数据
- TOOLS.md：工具权限声明与使用规范
- BOOTSTRAP.md：首次启动引导文件，一次性使用后应删除
- Memory 目录：Agent 的长期记忆机制，按日期滚动存储
Key Entities
- OpenClaw：AI Agent 管理工具，支持 workspace 个性化配置
- DracoVibeCoding：本文作者，公众号「Draco正在VibeCoding」
Connections
- OpenClaw ← contains ← Workspace
- Workspace ← manages ← AGENTS.md
- Workspace ← manages ← SOUL.md
- Workspace ← manages ← USER.md
- SOUL.md ← complements ← IDENTITY.md
- BOOTSTRAP.md ← initializes ← IDENTITY.md, USER.md, SOUL.md
Contradictions
- （暂无）