4.4 KiB
4.4 KiB
title, type, tags, date
| title | type | tags | date | |||||
|---|---|---|---|---|---|---|---|---|
| 万字讲透OpenClaw Workspace深度解析 | source |
|
2026-03-21 |
Source File
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
- 暂无发现冲突内容