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]
|
||
date: 2026-03-21
|
||
---
|
||
|
||
## Source File
|
||
- [[raw/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
|
||
- 暂无发现冲突内容
|