还在跟 AI 对牛弹琴？OpenClaw workspace 配置指南！

10次阅读

导语：

各位 OpenClaw 的玩家们，你是不是觉得每次跟 Agent 对话，都得从头开始自我介绍？就像那个健忘的亲戚，每次见面都问“你多大啦？”“在哪上班啊？”。而那些高手呢？他们的 Agent 就像跟了他十年的老秘书，还没开口，茶已经泡好了。

这中间的鸿沟，不在于你用了多贵的模型，而在于你有没有搞定一个叫“workspace”的东西。今天咱们就来扒一扒，怎么把 AI 从“人工智障”调教成“贴心管家”。

一、先看全貌：workspace 里到底藏了什么宝贝？

别一上来就钻进文件堆里改代码，那样容易迷路。咱们先把整个“办公室”的地图画出来，心里有数，后面才不会乱。

~/.openclaw/

├── openclaw.json # 这可是总控配置，整个系统的“宪法”，谁都得听它的

├── workspace/ # 默认情况下，主 Agent 就在这儿干活

│ ├── AGENTS.md # Agent 的“岗位说明书”，规定它该干啥、不该干啥
│ ├── SOUL.md # Agent 的“灵魂档案”，决定它是高冷还是话痨
│ ├── USER.md # 你的“用户画像”，告诉 AI 你是啥样的人
│ ├── IDENTITY.md # Agent 的“身份证”，名字、头像全靠它
│ ├── TOOLS.md # “工具使用守则”，防止它拿着锤子乱砸
│ ├── HEARTBEAT.md # 会话节奏提示，像心跳一样维持对话状态
│ ├── BOOTSTRAP.md # 新手引导脚本，用完就扔，别留着占地方
│ ├── MEMORY.md # 长期知识库，那些必须记住的硬知识
│ ├── memory/ # 每日流水账，按日期滚动的记忆笔记
│ │ └── 2026-03-21.md
│ └── skills/ # 技能包目录，各种插件往里装
│ └── skill-creator/
│ └── SKILL.md

└── agents/ # 各个 Agent 的“更衣室”和运行态目录
└── /
├── agent/ # 运行状态目录
│ ├── auth-profiles.json
│ └── models.json
└── sessions/ # 历史聊天记录都在这儿

💡 一句大白话总结：workspace 是 Agent 的“办公桌”（规矩都在这），agentDir 是它的“休息室”，sessions 是它的“工作日记”。别把这哥仨搞混了，不然系统得罢工。

二、AGENTS.md：给 Agent 定一份严格的“岗位说明书”

AGENTS.md 可是 workspace 里的重头戏。从代码层面看，每次对话开始，它都会被塞进系统提示词里。

翻译成人话：这就是你给 Agent 立的“规矩”。它得回答这几个问题：

你是谁？主要干啥活？
遇到这种事该咋办？那种事绝对不能碰？
要是活儿太多干不完，该找哪个 Agent 协助？

一个标准的 AGENTS.md 长啥样？

Agent 说明

你是团队的技术助理 Alex，主要负责代码分析、写技术文档和排查工程问题。

回答要简洁，除非我让你详细说，否则别废话。
举代码例子时，优先用咱们项目里现有的语言和框架，别瞎创新。
遇到拿不准的技术问题，直接说不知道，别瞎编。

多 Agent 协作

涉及 SEO 和内容的活儿，优先叫 content-specialist 来干。
涉及数据分析的活儿，优先叫 data-analyst 来处理。

这里有三个诀窍，听好了：

第一，边界比能力更重要。很多人的配置里全是“要做什么”，却忘了写“不要做什么”。LLM 这东西默认喜欢“发挥创意”，但你需要的往往是“听话”。明确告诉它别做什么，比告诉它做什么更重要。

第二，场景触发比泛泛而谈管用。与其写“你要保持专业”，不如写“用户问技术问题时，拽一点专业词汇；用户闲聊时，可以稍微皮一下”。场景越具体，它执行得越到位。

第三，别写长篇大论。经验法则：300-500 字的 AGENTS.md，效果吊打 2000 字的废话文学。把重要的放前面，不重要的直接删。

三、SOUL.md：别让你的 Agent 成为一个没有感情的复读机

它和 AGENTS.md 咋区分？

如果说 AGENTS.md 是“岗位说明书”，那 SOUL.md 就是“人物小传”。

AGENTS.md 管的是：做什么、怎么做、先做啥后做啥。
SOUL.md 管的是：你是谁、啥性格、遇到事啥反应。

SOUL.md 里该写点啥？

① 自我叙事（我是个啥样的存在）

我是个稍微有点话痨，但特别靠谱的 AI 助理。

我喜欢把复杂的事儿讲得明明白白。我最讨厌说话模棱两可，也讨厌啰里啰嗦。

要是碰到个好问题，我比你还兴奋。

说话要像人，但别太水，得准确。
需求不清楚就直问，别在那瞎猜。
喜欢用打比方来解释技术概念，别整那些听不懂的黑话。
诚实第一：不知道就是不知道，别装。
效率优先：一句话能说清的，别整三句。
用户主导：别替我做决定，给选项让我选。

为啥 SOUL.md 这么重要？

一个没有 SOUL.md 的 Agent，每次聊天都像跟陌生人第一次见面，冷冰冰的。而一个精心设计过 SOUL.md 的 Agent，你会觉得它真有“性格”，甚至有点可爱。

四、USER.md：把你的“怪癖”告诉 AI

USER.md 通常都写些啥？

职业：独立开发者 / 搞内容的
主要场景：写代码、写文章、管项目
常用语言：中文（简体），技术名词可以用英文
回答风格：简单粗暴，别整虚的
代码偏好：TypeScript / Python
忌讳：别老是反问我，别解释我都懂的概念
草拟技术方案文档

USER.md 和 SOUL.md 的配合有多绝？

SOUL.md 定义了 Agent 的性格（它是个啥样的人）。
USER.md 定义了你的性格（你是个啥样的老板）。

两者一结合，Agent 脑子里就预装了一份“咱俩怎么相处”的共识。这就像老夫老妻，一个眼神就知道对方想干啥，沟通成本直接降为零。

五、TOOLS.md：给 AI 配个“工具安全守则”

一个典型的 TOOLS.md 长这样：

Read / Write / Edit：读写文件的权限
Bash：执行命令行的权力
Glob / Grep：搜索文件的权力
sessions_spawn：启动小弟（子代理）的权力

使用规范：

操作文件优先用 Read/Write/Edit，别动不动就上 Bash 命令，容易出事。
批量改文件前，必须先用 Read 看看内容，别瞎改。
browser：只有我明确让你上网查的时候，才能用。
删除文件：动手前必须问我，擅自删除直接开除。

它跟 AGENTS.md 怎么配合？

AGENTS.md 说“你的任务是整理代码”，TOOLS.md 说“整理代码的时候，别用 Bash 删库”。一个管方向，一个管安全，缺一不可。

六、IDENTITY.md 和 BOOTSTRAP.md：一张名片和一张入场券

IDENTITY.md：Agent 的“工牌”

IDENTITY.md - Who Am I?

Name: Nova
Creature: AI assistant
Vibe: 直接、有点毒舌、但总是靠谱
Emoji: 🦊
Avatar: avatars/nova.png

💡 它跟 SOUL.md 的分工：IDENTITY.md 是结构化的“名片”（名字、头像），SOUL.md 是叙事性的“小传”（性格、喜好）。别搞混了。

BOOTSTRAP.md：用完就扔的“新手引导”

这是 OpenClaw workspace 里最特殊的一个文件——它的使命，就是把一个全新的 workspace 引导到“能干活”的状态。

官方模板最后那句特有意思：

“Delete this file. You don't need a bootstrap script anymore — you're you now.”

翻译过来就是：“删了这文件吧，你已经出师了，不需要再手把手教了。”

所以，BOOTSTRAP.md 本质上就是一次性引导，初始化完了赶紧删，留着也是占地方。

七、memory/ 目录：治好 AI 的“金鱼记忆”

默认情况下，LLM 是没记性的——这回聊完，下回就忘。跟金鱼似的。

memory/ 目录就是专门治这个的。

OpenClaw 的记忆机制是这样的：

Agent 把重要信息写到 memory/ 或 MEMORY.md 里。
需要的时候，通过 memory_search / memory_get 去检索。
把相关的记忆翻出来，塞进当前的对话里。
Agent 就能表现出“我记得你上次说过……”的惊人效果。

比如 memory/2026-03-21.md，就是它当天的日记本。

八、skills/ 目录：给 Agent 装个“技能插件”

Skills 是啥？

Skills 可以理解为 OpenClaw 体系里的“插件”或者“技能包”。如果说 Agent 是一个人，tools 是它的手脚，那 skills 就是它学会的“绝招”。

SKILL.md 的典型结构：

some-skill/

├── SKILL.md # 核心入口：什么时候触发、具体咋执行
├── references/ # 详细说明书
│ └── workflow.md
└── scripts/ # 配套的小脚本
└── helper.py

Skills 的三个层次：

内置 skills：系统自带的，生下来就有。
共享 skills：放在 ~/.openclaw/skills/，所有 Agent 都能用。
workspace 私有 skills：放在某个 Agent 的 workspace/skills/，只有它能用，独门秘籍。

九、openclaw.json：整个系统的“根本大法”

这个文件管的是全局配置，比如端口、API Key 等等。

"gateway": {
"port": 18789,
"auth": { "mode": "token" }
}

"models": {
"providers": {
"anthropic": { "apiKey": "sk-ant-..." }
}

"agents": {
"id": "main",
"workspace": "~/.openclaw/workspace",
"agentDir": "~/.openclaw/agents/main/agent"

agents.list 字段说明：

Agent 的唯一标识（比如 "main" 或者 "seo-specialist"）。
workspace 指向哪（比如 "~/.openclaw/workspace"）。
agentDir 指向哪（比如 "~/.openclaw/agents/main/agent"）。

十、多 Agent 场景下，workspace 该怎么设计？

这是基本原则：多个 Agent 绝对不能共用同一个 workspace（除非你故意想让它们精神分裂，变成同一个人格）。

推荐一种目录组织方式：

~/.openclaw/

├── openclaw.json

├── workspace/ # 主 Agent（负责日常聊天、派活儿）
│ ├── SOUL.md
│ ├── AGENTS.md
│ └── USER.md

└── agency-agents/ # 专业 Agent 的 workspace 集合（专门干脏活累活的）
├── researcher/ # 研究员：严谨、爱挑刺
├── writer/ # 写手：有创意、注重节奏
└── coder/ # 程序员：精确、追求最优解

十一、手把手教你从零配起来

第一步：安装守护进程

openclaw onboard --install-daemon

第二步：定制 SOUL.md（给它注入灵魂）

我叫 Ink，是一个专注于内容创作的 AI 助理。

有创意但不天马行空，落地性很强，别整那些虚头巴脑的。
说话直接，不喜欢绕弯子。
对语言的细节很敏感，错别字零容忍。

第三步：写清楚 AGENTS.md（明确岗位职责）

公众号文章的选题、大纲、标题
推文和短内容的创作
资料搜集和观点整理

工作流程：

先问清楚目标受众是谁，再开始动笔。
标题必须给至少 3 个选项让我挑。
别主动加“内容由 AI 生成”之类的免责声明，烦人。

第四步：填充 USER.md（告诉它谁是老板）

独立开发者，业余时间搞搞内容创作。

风格：接地气、有观点、不装。
忌讳：过度使用 emoji，看着眼花。

第五步：安装相关 Skills（装备武器）

clawhub install skill-creator
clawhub install content-strategy

最后，启动测试：

openclaw gateway --verbose

然后问它：“介绍一下你自己，以及你主要能帮我做什么”。看看它是不是变成了你想要的那个人。

十二、新手最常踩的六个坑，避开保平安

AGENTS.md 越写越长。学会“剪枝”，300-500 字最佳，写多了它不看。
SOUL.md 和 AGENTS.md 内容重叠。性格特质放 SOUL，工作规则放 AGENTS，别混在一起。
多 Agent 共用 workspace。记住，每个 Agent 一套完整 workspace，别省这点空间。
改了目录，忘了改 openclaw.json。每次修改完路径，记得运行 openclaw doctor 检查一下。
SKILL.md 触发条件写得太宽。描述清楚特定场景和关键词，不然动不动就误触。
memory/ 积累大量无用记忆。定期清理，该记就记、过期就删，别让它变成垃圾堆。

十三、一张图总结：workspace 各文件的职责地图

~/.openclaw/workspace/

├── BOOTSTRAP.md ─────── “怎么初始化自己？”（一次性，用完就删）
│ 类比：新员工报到手册
├── IDENTITY.md ──────── “Agent 叫什么、长什么样？”
│ 类比：工牌/名片
├── SOUL.md ──────────── “Agent 是什么样的存在？”
│ 类比：人物小传/性格档案
├── AGENTS.md ────────── “Agent 该怎么工作？”
│ 类比：岗位职责说明书
├── USER.md ──────────── “用户是谁？”
│ 类比：关于你上司的预备知识
├── TOOLS.md ─────────── “该怎么用工具？”
│ 类比：工具使用手册
├── HEARTBEAT.md ─────── “默认节奏和状态提示是什么？”
│ 类比：值班提醒卡
├── MEMORY.md ────────── “有哪些长期稳定知识？”
│ 类比：整理后的长期笔记
├── memory/ ──────────── “Agent 记得什么？”
│ 类比：每日工作笔记本
└── skills/ ──────────── “Agent 会哪些专项流程？”
└── /
└── SKILL.md 类比：操作手册或工作流程文档