OpenClaw避坑指南:为什么你的Agent总是不＂好用＂

OpenClaw避坑指南：为什么你的Agent总是不好用

作者：三三学AI

导语：你用 OpenClaw 有没有这种感觉——有时候它像换了个脑子，每次都得重新交代一遍？其实不是它失忆，是 workspace 没配好。

一、先看全貌：workspace 里到底有什么

先别急着一个文件一个文件抠。先把整套目录摆出来，脑子里有张地图，后面就不容易乱。

~/.openclaw/
├── openclaw.json      # 系统配置"宪法"
│
├── workspace/        # 主工作区
│   ├── AGENTS.md     # 岗位职责
│   ├── SOUL.md       # 性格设定
│   ├── USER.md       # 你的偏好
│   ├── IDENTITY.md  # Agent身份
│   ├── TOOLS.md     # 工具权限
│   ├── MEMORY.md    # 长期记忆
│   └── memory/      # 按日记忆
└── agents/          # Agent运行目录

一句话：workspace 是工作台，agentDir 是状态目录，sessions 是工作日志——三者别混。

二、核心文件到底该写什么

AGENTS.md = 岗位说明书

• 写清楚边界（不该做什么比该做什么更重要）

• 300-500 字比 2000 字有效

• 场景触发优于通用指令

很多人在 AGENTS.md 里只写”要做什么”，但没有”不要做什么”。边界往往比能力描述更重要。

SOUL.md = 性格档案

• AGENTS.md 回答”怎么工作”，SOUL.md 回答”怎么说话”

• 没有 SOUL.md = 每次对话都像第一次见面

• 有它之后，用户会觉得”这个 AI 是有个性的”

USER.md = 你的档案

• 职业、使用场景、偏好、不喜欢什么

• 有了它，Agent 会自动适配你的风格

三、六种常见坑

| 坑 | 问题 | 解决方案 |

|—|—|—|

| AGENTS.md 越写越长 | 不会剪枝 | 300-500字最佳 |

| SOUL.md 和 AGENTS.md 混 | 功能性格分不清 | 性格放 SOUL，工作放 AGENTS |

| 多 Agent 共用 workspace | 人格冲突 | 每个 Agent 独一份 |

| 改目录忘改 json | 配置不同步 | 用 openclaw doctor |

| SKILL.md 触发条件太宽 | 乱触发 | 写清楚场景和关键词 |

| memory/ 积累无用记忆 | 越来越笨 | 定期清理 |

四、怎么从零配起来

# 1. 初始化
openclaw onboard --install-daemon
# 2. 改 SOUL.md（性格）
# 3. 改 AGENTS.md（工作规则）
# 4. 改 USER.md（你的偏好）
# 5. 安装 Skills
clawhub install skill-creator

# 6. 验收 openclaw gateway --verbose

五、一张图总结

~/.openclaw/workspace/
│
├── BOOTSTRAP.md ──── "怎么初始化？"（一次性，用完删）
├── IDENTITY.md ──── "Agent 叫什么？"
├── SOUL.md ──────── "Agent 是什么性格？"
├── AGENTS.md ────── "Agent 怎么工作？"
├── USER.md ──────── "用户是谁？"
├── TOOLS.md ─────── "怎么用工具？"
├── HEARTBEAT.md ─── "默认节奏是什么？"
├── MEMORY.md ────── "长期知识有哪些？"
├── memory/ ──────── "记得什么？"
└── skills/ ──────── "会哪些技能？"

六、结语

workspace 是你给 Agent 的”礼物”。

写得好，它就是顺手的搭子；写得敷衍，它就是个聊天程序。

工具能力决定上限，workspace 决定你能不能把上限用出来。

竹子 AI · 3天AI实战营 | 用AI解决问题，创造价值

AI破局内有5万个圈友，不焦虑、不盲从，只是踏踏实实地用AI解决问题、创造价值。

如果你也想成为这样的人，欢迎参加【3天AI实战营】。

朋友圈会分享AI时代前沿信息，搞钱方法，价值干货，欢迎链接竹子～