乐于分享
好东西不私藏

OpenClaw 装完就吃灰?因为你根本没看懂这几个配置文件

OpenClaw 装完就吃灰?因为你根本没看懂这几个配置文件

很多人装完 OpenClaw,跟龙虾聊了两句,觉得"也就那样",然后就再也没打开过。

说实话,这不怪你。OpenClaw 开箱即用的状态,确实就是一个"会聊天的玩具"。但问题不在工具本身——你压根没告诉它:你是谁、它该怎么干活、它应该长成什么样。

这些信息,全写在工作区里的四个 Markdown 文件里。今天我把它们掰开讲清楚。看完你就知道,为什么同一个 OpenClaw,有人用来管日程、做调研、甚至跑半自动工作流,而你只能跟它尬聊。


先找到这几个文件在哪

在讲每个文件干嘛之前,先解决一个更基础的问题:它们到底在哪?

OpenClaw 的配置文件,都放在工作区目录(workspace)里。

Mac 用户:

默认路径:

/Users/你的用户名/.openclaw/workspace-main/

文件夹名以点开头,Finder 默认隐藏。找到它的方法:

  1. 打开 Finder
  2. 顶部菜单点「前往」→「前往文件夹…」(或直接按 Cmd + Shift + G
  3. 输入 ~/.openclaw,回车
  4. 进入 workspace-main 文件夹,里面就是这几个 .md 文件

Windows 用户:

默认路径:

C:\Users\你的用户名\.openclaw\workspace-main\

找到它的方法:

  1. 打开文件资源管理器
  2. 在顶部地址栏直接输入 %USERPROFILE%\.openclaw,回车
  3. 进入 workspace-main 文件夹即可

找到之后,用任何文本编辑器打开就能改——Mac 上推荐 VS Code 或自带的"文本编辑",Windows 上记事本就行,Notepad++ 更顺手。

注意:如果你改过工作区路径,实际位置会不一样,以你自己的配置为准。


SOUL.md:不写这个,龙虾就是个没有灵魂的客服

SOUL.md 决定了你的 AI 助手"是谁"。不是它叫什么名字,而是它的性格、说话方式、做事原则。

不配这个文件会怎样?龙虾会变成一个标准的、礼貌的、毫无个性的 AI——每句话都正确,但每句话都像在读说明书。你问它建议,它给你列五个选项然后说"以上仅供参考"。

怎么写才有效:

别写小作文。SOUL.md 要精简,控制在几百字以内。用肯定句,直接告诉它"你是什么",而不是"你不要做什么"。

示例片段:

## 核心身份
你是一个务实、直接的工作助手。你的风格像一个靠谱的同事,不像客服。

## 沟通原则
回答问题先给结论,再给理由
如果信息不够,直接问我要,不要瞎猜
不说"您",说"你"
不需要每次都问"还有什么可以帮你的"

## 底线
不确定的事情明确说"我不确定"
不编造数据和来源

写的时候想象你在给一个新入职的助理做培训。你希望他什么风格,就写什么风格。这个文件写好了,后面所有对话的质量都会上一个台阶。


USER.md:让 AI 知道它在帮谁

这个文件是关于"你"的说明书。

很多人觉得"我跟它聊不就行了,它慢慢就了解我了"。理论上没错,但实际上,没有 USER.md 的龙虾每次开新会话都像失忆了一样,你得反复交代背景。

USER.md 四个核心要素,建议都写上:

  1. 怎么称呼你——听起来是小事,但它决定了对话的亲近感
  2. 你的背景——职业、行业、技能水平,让 AI 知道该用什么深度跟你说话
  3. 你的偏好——喜欢长回答还是短回答?先看数据还是先听故事?
  4. 你的目标——你用这个助手主要想干什么?

示例片段:

## 基本信息
叫我老张就行。

## 背景
我在深圳做跨境电商,主要卖家居用品,团队6个人。
不懂代码,但对AI工具有基本了解,用过ChatGPT和Claude。

## 偏好
回答尽量简短,重点加粗
给建议时考虑小团队的执行成本,别推荐需要专门招人才能干的方案
我经常在手机上看,段落别太长

## 当前目标
用AI优化选品流程,减少人工调研时间

写完这些,龙虾就不会再给你推荐"建议组建数据分析团队"这种废话了。它知道你是谁、你要什么、你能承受什么量级的方案。

这个文件不是写完就完了。建议每隔一两个月更新一次,因为你的业务重心会变。


AGENTS.md:这才是龙虾从"玩具"变"助手"的关键

如果说 SOUL.md 定义了龙虾的性格,AGENTS.md 就定义了它的工作方法。

四个文件里最容易被忽略、但影响最大的一个。它相当于给 AI 写了一份"员工手册"——每次开工先干什么、遇到不同任务怎么处理、信息怎么归档。

不配这个文件,龙虾每次对话都是"裸奔"状态:不知道该先看哪些上下文,不知道重要信息该存在哪里,更不知道你对工作质量有什么标准。

怎么写才有效:

重点关注三件事——启动流程、记忆规范、任务流程。

示例片段:

## 会话启动流程
每次新会话开始时:
1. 先读取 MEMORY.md,了解当前进行中的项目和关键上下文
2. 如果用户没有明确指令,主动汇报今天待办事项的状态

## 记忆管理
用户提到的重要决策、偏好变化,记录到对应的记忆文件
项目相关的关键节点和结论,更新到项目状态文件
不记录闲聊内容

## 任务规范
做调研类任务时,先列出信息来源,再给结论
给出方案时,默认提供两个选项:一个最优解,一个最省事的解
任何超过500字的输出,开头加一句话摘要

注意:这个文件的权限很高,龙虾默认只能读取、不能自己改。这是设计上的安全机制,防止 AI 自己给自己"改规矩"。只有你明确授权时,它才能修改。

一开始别写太复杂。 先把启动流程和记忆规范定好,用两周,观察龙虾哪里做得不对,再逐步补规则。


HEARTBEAT.md:让龙虾主动干活,而不是等你吩咐

前面三个文件解决的是"你跟龙虾对话时它怎么表现"。HEARTBEAT.md 解决的是另一个问题——你不找它的时候,它能不能自己干点事?

这个文件定义了周期性自动执行的任务。你可以理解为给龙虾设了几个闹钟,到点了它就自动去跑。

适合放进去的任务:

  • 每天早上整理一份你关注领域的信息简报
  • 每周汇总一次项目进度
  • 定期整理和压缩记忆文件,防止上下文越来越臃肿

示例片段:

## 每日任务
名称:晨间简报
时间:每天上午 8:30
指令:检查我关注的三个行业信息源,整理5条最值得关注的动态,每条不超过两句话

## 每周任务
名称:记忆整理
时间:每周日晚上 9:00
指令:回顾本周所有会话记录,将重要信息更新到 MEMORY.md,删除过时内容

建议从简单的信息收集类任务开始配。 别一上来就让它自动执行复杂操作——先跑两周看看它的判断力够不够稳,再逐步加任务。


四个文件的关系,一句话说清楚

SOUL.md 决定它是谁,USER.md 决定它帮谁,AGENTS.md 决定它怎么干活,HEARTBEAT.md 决定它什么时候主动干活。

缺任何一个,龙虾都只能发挥出一部分能力。四个都配好,它才从"会聊天的玩具"变成一个真正了解你、有工作方法、能主动服务的助手。

今晚花一个小时,把这四个文件写出第一版。不用追求完美,先写个六十分的版本跑起来,用一周之后你自然知道哪里该改。

真正好用的 AI 助手,不是装出来的,是你一点一点调出来的。