Auto-sync: 2026-04-27 08:02
This commit is contained in:
@@ -1,57 +1,57 @@
|
||||
---
|
||||
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
|
||||
- 无已知冲突
|
||||
|
||||
---
|
||||
title: "万字讲透OpenClaw Workspace深度解析"
|
||||
type: source
|
||||
tags: [OpenClaw, Agent, Workspace, AGENTS.md, SOUL.md]
|
||||
date: 2026-03-21
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/万字讲透OpenClaw-Workspace深度解析-2026-03-21.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：OpenClaw workspace 文件体系详解，从"能用"到"真好用"的分水岭
|
||||
- 问题域：Agent 每次对话都需要重新 onboarding 的痛点，以及 workspace 如何解决长期记忆和行为一致性问题
|
||||
- 方法/机制：通过 workspace 目录下的一系列 Markdown 文件（AGENTS.md、SOUL.md、USER.md、IDENTITY.md、TOOLS.md、BOOTSTRAP.md、memory/）实现 Agent 的身份、性格、用户偏好、工具规范的持久化
|
||||
- 结论/价值：这套文件体系让 Agent 不再是每次都重新 onboarding 的陌生人，而成为真正懂用户、记得用户、靠谱的长期搭档
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- workspace 是"能用"到"真好用"的分界线：通过持久化文件让 Agent 记住上下文、偏好和积累的知识
|
||||
- AGENTS.md 是岗位说明书：定义 Agent 做什么、怎么做、优先级，以及多 Agent 协作方式；300-500 字比 2000 字更有效
|
||||
- SOUL.md 定义 Agent 的性格叙事：与 AGENTS.md 分工明确，前者偏功能性，后者偏人格性，两者不应混写
|
||||
- USER.md 固化用户偏好：把反复要交代的背景信息沉淀为默认背景，减少重复 onboarding
|
||||
- TOOLS.md 规范工具使用：明确什么时候该用、什么时候不该用，降低权限越界风险
|
||||
- IDENTITY.md 是结构化身份档案：与 SOUL.md 分工明确，前者管元数据（名字/emoji/头像），后者管性格叙事
|
||||
- BOOTSTRAP.md 是一次性引导：使命是把新 workspace 引导到可用状态，完成后应删除
|
||||
- memory/ 目录是 Agent 真正的长期记忆：LLM 对话无状态，通过文件工具读写 memory/ 目录实现跨会话记忆
|
||||
|
||||
## Key Quotes
|
||||
> "workspace 是 Agent 的工作台（决定怎么工作），agentDir 是 openclaw.json 里的配置字段（指向存放运行状态的目录），sessions 是工作日志（记对话历史）。三者职责不同，不要混为一谈。" — workspace、agentDir、sessions 的职责区分
|
||||
> "AGENTS.md 不是越长越好。300-500 字的 AGENTS.md，比 2000 字的更有效。" — AGENTS.md 最佳实践
|
||||
> "对 Agent 来说，真正算数的长期记忆，是 workspace 里那些 Markdown 文件，不是什么看不见摸不着的黑盒数据库。" — 记忆机制的核心原则
|
||||
> "BOOTSTRAP.md 的使命，是把一个全新的 workspace 引导到可正常使用的状态。" — BOOTSTRAP.md 的作用
|
||||
> "Delete this file. You don't need a bootstrap script anymore — you're you now." — BOOTSTRAP.md 官方模板结尾
|
||||
|
||||
## Key Concepts
|
||||
- [[OpenClaw Workspace]]：OpenClaw 的 Agent 工作区目录，包含 AGENTS.md、SOUL.md、USER.md 等文件
|
||||
- [[AGENTS.md]]：Agent 的行为规则与多 Agent 协调文件，定义职责、边界和优先级
|
||||
- [[SOUL.md]]：Agent 的叙事性格设定文件，定义 Agent 的说话风格、价值观和个性
|
||||
- [[USER.md]]：用户画像与偏好文件，把用户的偏好固化下来减少重复交代
|
||||
- [[IDENTITY.md]]：Agent 身份元数据文件（名字/emoji/头像），与 SOUL.md 分工明确
|
||||
- [[TOOLS.md]]：工具权限声明与使用规范文件，减少工具误用和权限越界
|
||||
- [[BOOTSTRAP.md]]：首次启动引导文件，完成初始化后应删除
|
||||
- [[memory目录]]：按日期滚动的记忆笔记目录，实现 Agent 的跨会话长期记忆
|
||||
- [[bootstrapMaxChars]]：控制 AGENTS.md 等文件加载长度的配置参数
|
||||
- [[AgentDir]]：openclaw.json 中的配置字段，指向存放运行状态（auth-profiles.json、models.json）的目录
|
||||
- [[Sessions目录]]：会话历史目录，存放 *.jsonl 文件
|
||||
|
||||
## Key Entities
|
||||
- [[DracoVibeCoding]]：本文作者，公众号"Draco正在VibeCoding"
|
||||
- [[OpenClaw]]：开源 AI Agent 框架，workspace 是其核心特性之一
|
||||
|
||||
## Connections
|
||||
- [[养龙虾5天血泪史-我的ai-agent为什么总失忆-openclaw-记忆调试全记录]] ← relates_to ← [[万字讲透openclaw-workspace深度解析-2026-03-21]]
|
||||
- [[Google 5个 Agent Skill 设计模式]] ← extends ← [[万字讲透openclaw-workspace深度解析-2026-03-21]]
|
||||
- [[系统提示词构建原则]] ← extends ← [[万字讲透openclaw-workspace深度解析-2026-03-21]]
|
||||
|
||||
## Contradictions
|
||||
- 暂无发现冲突内容
|
||||
|
||||
Reference in New Issue
Block a user