大多数人装了 OpenClaw、连上一个频道,就再也不碰 workspace 文件夹了。这等于雇了个员工,却从来不给他工作描述。
OpenClaw 的全部威力藏在 workspace 里。以下是让 setup 真正发挥作用的 80/20 原则。
1. AGENTS.md:最高杠杆文件
AGENTS.md 是整个 workspace 里最重要的文件。它存放核心指令、硬规则和工具说明。保持在 300 行以下。
ETH Zurich 的研究已经证明了:上下文文件超过 80 行之后,Agent 的指令遵循质量开始下降。不是越长越好——越精确越好。
2. 三个身份文件
- IDENTITY.md:Agent 是谁。不是它做什么,是它是谁。
- USER.md:你是谁。你叫什么,怎么称呼你,时区和偏好。
- SOUL.md:它怎么沟通。语气、风格、价值观——让它听起来像一个真实的人,而不是一个聊天机器人。
这三个文件共同构成 Agent 的身份层。没有身份,Agent 就只是一个做任务的工具。有了身份,它才能成为真正的数字员工。
3. Skills 文件夹
每个 workflow 对应一个 SKILL.md。会议准备、内容写作、邮件草稿——每个 skill 把一个 20 分钟的任务变成一条命令。
Skill 是 OpenClaw 的可扩展性来源:把常用工作流封装成可复用的 skill,你就不用每次重新描述任务,Agent 也不用每次重新学习怎么做。
4. Memory 文件夹
memory/YYYY-MM-DD.md 的每日日志。没有这个,每次 session 都从零开始,Agent 无法积累任何长期上下文。
Dave Morin(OpenClaw 创始人)提出了更完整的三层架构:SOUL.md 定义身份,MEMORY.md 积累经历,DREAMS.md 整合升华。这三个文件让 Agent 真正拥有连续性,而不是每次对话都是冷启动。
5. .secrets 文件夹
API token 放这里,永远不要放进 AGENTS.md。一定要 .gitignore。它是 workspace 里唯一不需要也不应该进入版本控制的东西。
6. HEARTBEAT.md
控制 Agent 在定时检查时做什么。这是让 Agent 变得主动而非被动的关键:它不再只是响应你的指令,而是在你不在的时候主动工作——检查邮件、日历、通知,把需要你注意的东西推送给你。
执行顺序
先搞定 AGENTS.md。那是基础,其他一切都是优化。
和刚才那篇 CLAUDE.md 的发现呼应——"不要塞满,要精准"。Workspace 的每个文件都应该回答一个这个问题:"没有它,Agent 会犯什么错?"能回答的才值得写。</parameter>