夜雨聆风
OpenClaw 工作区配置指南:让 AI 助手真正懂你
90% 的用户装好 OpenClaw 、连上飞书后，就再也没碰过工作区文件夹。这是一个巨大的浪费——你的工作区才是 OpenClaw 的灵魂。
🐌 别再只当「安装选手」了
我见过太多人安装好 OpenClaw ，配置好频道，然后就把它丢在角落里吃灰。
“能用啊，会回复消息，够了。”
够了吗？远远不够。
你的工作区文件夹里，藏着 OpenClaw 的「控制面板」。你的身份、偏好、自定义技能、跨会话记忆——全部都在这里。
搞懂了这套架构， OpenClaw 从一个「会自动回复的机器人」变成「真正懂你的 AI 搭档」。
今天把这套架构掰开了揉碎了讲。
🏗️ 两大配置层：你的 vs 全局的
在动手之前，先搞懂 OpenClaw 的配置结构。
OpenClaw 有两层配置：
第一层：工作区文件夹
通常在 .openclaw/workspace/（或者你初始化时指定的位置）
这里放的是你的个人配置：
– 身份定义
– 自定义技能
– 记忆文件
– API 密钥
第二层：全局安装目录
通常是
/opt/homebrew/lib/node_modules/openclaw/
这里放的是OpenClaw 核心代码：
– 内置技能
– 默认行为
– 每次升级都会覆盖
简单说：
– 工作区 = 你定制的东西
– 全局安装 = 人家的地方，别乱动
📁 核心文件：一图流
.openclaw/workspace/
├── AGENTS.md # 你的核心指令集（最重要！）
├── SOUL.md # Agent 的性格和边界
├── IDENTITY.md # Agent 的身份定义
├── USER.md # 你的用户档案
├── HEARTBEAT.md # 定时任务的行为规则
├── TOOLS.md # 外部工具的使用笔记
│
├── skills/ # 自定义技能（可复用工作流）
│ ├── meeting-prep/
│ └── social-post-writer/
│
├── memory/ # 跨会话的长期记忆
│ └── 2026-04-10.md
│
├── .secrets/ # 敏感信息（必须 gitignore！）
│ └── anthropic-api-key.txt
│
└── output/ # 生成的文件
📋 AGENTS.md ：你的「最高杠杆文件」
这是整个配置里最重要的文件，没有之一。
OpenClaw 启动一个新会话时，第一个读的就是 AGENTS.md 。它会直接塞进系统提示词里，全程生效。
简单说：你写什么， agent 就听什么。
写什么？
别写什么？
⚠️ 关键提醒：别写太长
AGENTS.md 建议控制在 300 行以内。
文件太长会吃掉上下文窗口，而且——反直觉的是——指令越多， agent 反而越不听话。
最小有效示例
## 核心使命
我的助手是帮我处理业务问题的主动型助理。
## 核心要求：
- 主动帮我干活，别等我问
- 发邮件前必须我确认才能发送
- 每天同步任务进度
## 关键工具
- 邮件：每天检查收件箱，标红紧急邮件
- 日历：预约前用 `date` 命令确认日期
- 任务管理：完成后同步到看板
## 硬规则
- 绝对不能重启服务（除非我明确同意）
- 重要决策必须我确认
大约 20 行， agent 就能把事情干明白。
🎭 SOUL.md ：性格和边界
如果说 AGENTS.md 是「使用手册」， SOUL.md 就是「人格塑造」。
- 回复简洁直接
- 需要澄清的问题就问
- 绝不全链路/半成品回复发到外部消息平台
有人写得很详细，有人就几行。都行，取决于你想要多少「人设」。
🪪 IDENTITY.md + USER.md ：谁是谁？
这两个文件有多简单，就有多重要：
IDENTITY.md – 定义 agent 是谁：
- 名字：小苹果
- 风格：聪明、可靠、执着解决问题
- Emoji：🍎
USER.md – 定义你是谁：
- 名字：森哥
- 常用称呼：森哥
- 时区：Asia/Shanghai
- 电话：13xxxxxxxxx
- 日历：Google Calendar
分开的好处： IDENTITY.md 设好了就不用改， USER.md 跟着你的偏好变。维护成本最低。
💓 HEARTBEAT.md ：让 Agent 主动起来
这个文件定义了定时心跳检查时 agent 该干嘛。
**如果消息包含「⚠️ EXECUTION CRON」：**
- 这不是心跳检查，是要干活
- 完整读取消息里的指令
- 执行完别返回 HEARTBEAT_OK
**否则（普通心跳）：**
- 没事就返回 HEARTBEAT_OK
- 保持简洁
这才是 OpenClaw 的真正威力： agent 可以定时检查你的日历、扫描邮件、跑任何自动化流程。全都由心跳触发。
🔧 TOOLS.md ：你的工具使用笔记
这个文件不定义「有哪些工具」——那是 OpenClaw 内置的。
它记录的是「你怎么用这些工具」：
## 邮件 CLI
- 账号：your@email.com
- 常用命令：`cli email search`、`cli calendar create`
## 任务管理 API
- Token 位置：~/.secrets/task-api-token.txt
- 记得加 `limit=100` 避免分页问题
- 状态转换规则：[你自己的工作流]
## 爬虫工具
- 位置：.openclaw/workspace/.venv/scraper
- 碰到防爬的网站用 stealth 模式
这是你的个人参考手册。 agent 需要用某个工具时，会先查 TOOLS.md 找你的使用习惯。
🧠 Skills ：可复用的工作流
这是 OpenClaw 最强大的地方之一。
每个 skill 是一个独立的工作流， agent 觉得任务匹配时会自动调用：
skills/
├── meeting-prep/
│ └── SKILL.md
├── social-post-writer/
│ ├── SKILL.md
│ └── references/
│ └── templates.md
└── podcast-show-notes/
└── SKILL.md
SKILL.md 用 YAML frontmatter 描述什么时候触发：
---
name: meeting-prep
description: 自动会前调研和简报。用户问「看看有没有会议」或「准备会议」时触发。
---
## 触发条件：
- 用户要求检查即将到来的会议
- 每 10 分钟定时跑（通过 cron）
- 只为首次会议准备简报
## 流程：
1. 查看日历上下一个 15-45 分钟的会议
2. 研究参会人（LinkedIn、公司官网）
3. 创建简报文档
4. 挂载到日历事件链接
skill 和普通指令的区别： skill 可以带上额外的参考文件（ templates.md 、 examples.md ），这些文件只在 skill 触发时才加载，不占日常上下文。
📦 memory/：让 agent 记住跨会话的事
这是 OpenClaw 的「超能力」。
memory/
├── 2026-04-10.md
├── 2026-04-09.md
├── email-style.md
└── business-context-2026-02.md
最佳实践：
memory/YYYY-MM-DD.md没有 memory ， agent 每次会话都是从零开始。
🔐 .secrets/：敏感信息的保险箱
API tokens 、密码、凭证——全部放这里。
.secrets/
├── task-api-token.txt
├── openai-api-key.txt
└── service-credentials.txt
必须 gitignore ，千万别提交到版本控制。
你的 AGENTS.md 或 TOOLS.md 可以引用这些路径，但不会暴露具体值。
🚀 正确的入门顺序
如果你是新人，按这个顺序来：
第一步
运行 openclaw onboard，完成初始配置。选模型供应商，连至少一个频道。
第二步
创建工作区文件夹，写 AGENTS.md 。从 10-20 行核心指令开始，覆盖主要使用场景。
第三步
添加 IDENTITY.md 、 USER.md 、 SOUL.md 。确立关系和风格。
第四步
为重复性的工作流创建第一个 skill 。会议准备、邮件草稿、内容创作——都是好起点。
第五步
建立 memory/ 加上每日日志模板。 Agent 会开始跨会话积累上下文。
第六步
用 TOOLS.md 记录你发现的工具使用规律。
95% 的使用场景，有这些就够了。 进阶功能（ cron 定时任务、多 agent 设置、自定义频道插件）都是后面有明确需求再搞。
💡 真正重要的是什么
你的 OpenClaw 工作区，本质上是一套协议：告诉 AI 你是谁、你要什么、什么规则不能破。
定义得越清楚，纠正 agent 的时间越少，它帮你干活的时间越多。
AGENTS.md 是你最高杠杆的文件。先把这写对，其他都是优化。
从小处开始，边用边调整。把它当成工作流基础设施来维护——配好了，每天都受益。