58 lines
4.4 KiB
Markdown
58 lines
4.4 KiB
Markdown
---
|
||
title: "万字讲透OpenClaw Workspace深度解析"
|
||
type: source
|
||
tags: [OpenClaw, Agent, Workspace, AGENTS.md, SOUL.md]
|
||
sources: []
|
||
last_updated: 2026-03-21
|
||
---
|
||
|
||
## Source File
|
||
- [[Agent/万字讲透OpenClaw-Workspace深度解析-2026-03-21.md]]
|
||
|
||
## Summary（用中文描述）
|
||
- 核心主题：OpenClaw 的 workspace 目录体系——让 Agent 从"能用"进化到"真好用"的关键文件架构
|
||
- 问题域：Agent 个性化配置、长期记忆机制、多 Agent 协作时的行为一致性
|
||
- 方法/机制：通过 workspace 目录下的多个 Markdown 文件（AGENTS.md/SOUL.md/USER.md/IDENTITY.md/TOOLS.md/MEMORY.md 等）分别管理职责、性格、用户偏好、身份元数据、工具规范和长期记忆
|
||
- 结论/价值：workspace 文件配合好后，Agent 不再是每次都要重新 onboarding 的陌生人，而是一个真正懂你、记得你、靠谱的长期搭档
|
||
|
||
## Key Claims（用中文描述）
|
||
- OpenClaw 使用者存在一条隐形分界线：一边每次都要重新交代背景，另一边的 Agent 已知道用户是谁、该怎么说话——这条分界线就是 workspace
|
||
- workspace 管的是"Agent 平时怎么干活"（文件内容），openclaw.json 管的是"系统怎么把 Agent 跑起来"（配置参数），两者职责不同
|
||
- AGENTS.md 是岗位说明书（做什么、怎么做、边界在哪），SOUL.md 是性格档案（是谁、什么风格、怎么思考），两者不应混写
|
||
- 300-500 字的 AGENTS.md 比 2000 字的更有效——边界比能力描述更重要，LLM 默认会"发挥创意"需要约束
|
||
- SOUL.md 定义 Agent 性格，USER.md 定义用户偏好，两者放在一起相当于在 Agent 脑子里预装了"人机关系的基本共识"
|
||
- TOOLS.md 的核心价值是明确"什么时候不该用"比"什么时候该用"更重要，减少工具误用和权限越界
|
||
- 真正算数的长期记忆是 workspace 里那些 Markdown 文件，不是看不见的黑盒数据库——memory/ 目录让 Agent 真正拥有跨会话记忆
|
||
|
||
## Key Quotes
|
||
> "workspace 是 Agent 的工作台（决定怎么工作），agentDir 是 openclaw.json 里的配置字段（指向存放运行状态的目录），sessions 是工作日志（记对话历史）。三者职责不同，不要混为一谈。" — workspace 全貌区分
|
||
> "AGENTS.md 不是越长越好——300-500 字的 AGENTS.md，比 2000 字的更有效。" — 经验法则
|
||
> "一个没有 SOUL.md 的 Agent，每次对话都像第一次见面——它不记得自己是谁，说话没有固定风格。" — SOUL.md 必要性
|
||
> "对 Agent 来说，真正算数的长期记忆，是 workspace 里那些 Markdown 文件，不是什么看不见摸不着的黑盒数据库。" — 记忆机制核心洞察
|
||
|
||
## Key Concepts
|
||
- [[Workspace]]：Agent 的工作台目录（~/.openclaw/workspace/），包含 AGENTS.md、SOUL.md、USER.md 等配置文件，决定 Agent 怎么工作
|
||
- [[AGENTS.md]]：Agent 的工作说明书，定义职责、边界、多 Agent 协作流程；300-500 字最优
|
||
- [[SOUL.md]]：Agent 的性格档案，叙事性角色设定文档（与 IDENTITY.md 的结构化元数据分工明确）
|
||
- [[USER.md]]：用户画像与偏好固化，减少每次对话的重复交代
|
||
- [[IDENTITY.md]]：Agent 结构化身份元数据（Name/Creature/Vibe/Emoji/Avatar），与 SOUL.md 叙事分工
|
||
- [[TOOLS.md]]：工具权限声明与使用规范，明确"什么时候不该用"比"什么时候该用"更重要
|
||
- [[BOOTSTRAP.md]]：一次性出厂引导，完成初始化后应删除
|
||
- [[HEARTBEAT.md]]：会话节奏/状态提示的默认模板之一
|
||
- [[MEMORY.md]]：长期知识总表，与 memory/ 日期滚动目录共同构成 Agent 的持久记忆层
|
||
- [[Agent-Memory]]：OpenClaw 通过 builtin 或 qmd 方案，将重要信息写入 memory/ 或 MEMORY.md，下次对话通过 memory_search/memory_get 检索注入上下文
|
||
|
||
## Key Entities
|
||
- [[OpenClaw]]：本文的核心研究对象，multi-agent 框架，workspace 体系是其从"能用"到"真好用"的分水岭
|
||
- [[DracoVibeCoding]]：公众号"Draco正在VibeCoding"作者，本文原创作者
|
||
|
||
## Connections
|
||
- [[OpenClaw]] ← uses ← [[Workspace]]
|
||
- [[Workspace]] ← composed of ← [[AGENTS.md]], [[SOUL.md]], [[USER.md]], [[IDENTITY.md]], [[TOOLS.md]], [[MEMORY.md]]
|
||
- [[AGENTS.md]] ← informs ← [[Agent-Specialization]]
|
||
- [[Agent-Memory]] ← built on ← [[Workspace]] + [[MEMORY.md]] + [[memory/目录]]
|
||
|
||
## Contradictions
|
||
- 无已知冲突
|
||
|