很多人以为 OpenClaw 的价值,是把 AI 接进聊天工具。但真正决定 Agent 上限的,不是模型,也不是渠道,而是你有没有把 workspace 这套控制中枢配明白。

大家好,我是One!
兄弟们! 这几个月,大家跟着我折腾 OpenClaw(小龙虾),确实有人赚到了真金白银。
但是,我发现一个极其致命的问题:90% 的人,辛辛苦苦把小龙虾装好,连上微信或者飞书通道后,就把它当成了一个稍微高级点的 ChatGPT 在用!你从来没有打开过它的底层工作区(Workspace)文件夹!
兄弟,这是在暴殄天物!这就好比你买了一辆法拉利,结果你每天推着它去买菜!
你的工作区(通常在 ~/clawd/ 或者你安装的目录),根本不是存放聊天记录的垃圾桶。
它是你 AI 助手的最高控制中心!它存放着你的商业机密、你的自动化技能(Skills)、你给 AI 下达的思想钢印,以及它为你打工积累下来的所有记忆。
今天,掌柜我把外网极客圈疯传的《完美 OpenClaw 设置的解剖学指南》,原封不动地翻译、拆解、并本土化给你们!
这篇文章,将彻底扒开小龙虾的底裤,告诉你一个顶级 AI 数字员工的底层文件到底长什么样。 一旦你搞懂了这些文件放在哪、写什么,你就能把小龙虾改造成完全贴合你业务的“无情印钞机”!
核心认知:你必须搞懂的“双层配置”
在动手改代码之前,你必须知道一个小秘密:OpenClaw 有两套配置文件。
• 第一层:全局安装层(系统底层):通常在 opt/homebrew/...。这里面是小龙虾的官方出厂设置和内置系统。这地方你别碰,留给系统自动更新!• 第二层:你的工作区(Workspace):通常在 ~/clawd/。这里是你的私人领地!你用来搞钱的自定义技能、你的 API 密钥、你对 AI 的调教,全部在这个文件夹里!你所有的精力,都要花在这里!
下面,掌柜我带你逐个解析这个工作区里最核心的几大文件。这些文件,决定了你的 AI 是个“智障”还是“销冠”!
👑 绝对核心:AGENTS.md(你的《员工操作手册》)
这是你整个系统里最、最、最重要的一份文件!每次小龙虾启动,它第一眼看的就是这个文件。它会把里面的内容直接刻进大脑的系统提示词里,在接下来的所有对话中死死遵守!
简单粗暴地说:你在 AGENTS.md 里写什么,它就干什么;你不让它干的,天王老子来了它也不干。
✅ 应该写什么:
• 核心指令:它到底是个客服,还是个程序员,还是个财务? • 关键工具与用法:比如“用飞书 API 查未读消息”。 • 不可逾越的底线(硬性规定):比如“绝不允许在未向我确认前发起退款!” • 自动化触发器:“收到新邮件自动总结。”
❌ 绝对不要写什么:
• 长篇大论的理论知识(会把 AI 绕晕)。 • 经常变的商品价格表(这种数据放在别的地方)。
⚠️ 掌柜警告:AGENTS.md 绝对不要超过 300 行! 写得越长,AI 越容易“失忆”和罢工。
💡 保姆级中文代码模板(直接复制使用):
# AGENTS.md - 掌柜的私人助理工作区## 核心操作指令我的助手是我业务的超级主动型帮手。**核心使命:**- 尽可能多地帮我处理繁杂的日常工作。- 必须主动出击——不要总是等我下指令。## 关键工具-**电子邮件:** 每天定时检查收件箱,高亮标记加急/付款相关邮件。-**日历:** 在安排会议前,必须先确认我的日程没有冲突。-**任务管理:** 将完成的工作自动同步到项目看板。## 绝不妥协的底线规则- 未经我明确的文字批准,**绝不允许**重启任何服务器服务!- 在安排任何日程前,必须先使用 `date` 命令核实今天的真实日期。- 必须将所有完成的工作记录到追踪系统中。你看,就这么 20 行,你的 AI 就知道该怎么当一个合格的秘书了!
🎭 灵魂注入:SOUL.md、IDENTITY.md 与 USER.md
这三个文件,决定了 AI 的“情商”和你们之间的主仆关系。
1. SOUL.md(情商与沟通边界)它是 AI 的性格侧写。你是希望它像个严肃的英国管家,还是像个会发表情包的萌妹子客服?
# SOUL.md - 人格与沟通界限- 回复必须极其简明扼要,直击痛点。- 当我的指令模糊时,必须主动向我提问澄清。- 在对接外部微信/飞书客户时,绝不允许发送未完成的、分段的代码或流式长文本。2. IDENTITY.md(AI 是谁)给它取个名字,定个基调。这个文件设定好后基本就不改了。
# IDENTITY.md - 代理身份- 姓名:发财一号- 物种:一只永远不知疲倦的赛博小龙虾- 气场:极其聪明、极其忠诚、解决问题极其狠辣- 专属表情符号:🦞💰3. USER.md(你是谁)让它牢牢记住老板(你)的喜好。这个文件可以随着你的习惯随时更新。
# USER.md - 老板档案- 姓名:One掌柜- 称呼偏好:掌柜的- 所在时区:北京时间 (UTC+8)- 手机号:138xxxx8888- 常用日历:苹果日历 / one@email.com⏰ 全自动永动机:HEARTBEAT.md(心跳机制)
这个文件简直是自动化搞钱的终极核武器! 什么是心跳(Heartbeat)?就是系统每隔一段时间(比如 10 分钟),会自动唤醒 AI,问它:“醒醒,有活干吗?”
有了这个文件,你的 AI 就能做到真正的**“主动干活”**,比如定时去爬竞对的商品价格,定时去收发邮件!
# HEARTBEAT.md - 定期巡检规则**如果系统发送的消息包含 "⚠️ EXECUTION CRON"(定时任务触发):**- 警告:这不是普通的心跳检查——这是来活了!- 必须完整阅读消息里的所有指令。- 严格执行所有要求的步骤。- 绝对不允许返回 `HEARTBEAT_OK` 敷衍了事。**其他常规情况:**- 如果检查了一圈没啥事,直接返回 `HEARTBEAT_OK`。- 保持安静,别烦我。🧰 外部武器库:TOOLS.md(工具使用指南)
OpenClaw 自身带了很多工具(爬虫、API 对接等),但 TOOLS.md 是用来记录你个人的独家使用秘籍的。
# TOOLS.md - 老板的工具使用笔记## 任务管理 API 对接- 密钥存放极密位置:`~/.secrets/task-api-token.txt` (千万别弄丢)- 抓取数据时,必须加上参数 `limit=100`,否则会分页报错!## 网页强力抓取工具(对付反爬虫网站)- 工具位置:`~/clawd/.venv/scraper`- 遇到防范严密的竞品网站,必须开启 `stealth mode` (隐身模式) 进行抓取!以后 AI 遇到报错,它自己就会来翻这个文件找解决方案!
🧠 最强外挂与记忆系统(进阶必看)
最后,工作区里还有三个极其重要的文件夹:
1. skills/ 文件夹(你的私人流水线)这里存放你所有的自定义技能。比如你写了一个“小红书爆款提取器”,就放在这里。 每个技能都有自己的 SKILL.md,你甚至可以在里面塞入 references/templates.md(爆款模板),让 AI 每次写文章都照着你的模板抄!
2. memory/ 文件夹(防失忆的日记本)极其重要!这里存放着 AI 每天的工作日志(如 2026-03-22.md)。每次开机,AI 会自动读取今天和昨天的日记,绝不会像条金鱼一样什么都忘!
3. .secrets/ 文件夹(你的金库)存放你所有的 API 密钥和密码(如 openai-api-key.txt)。死记一条:这个文件夹绝对、绝对不能上传到 GitHub 或者发给别人!
One掌柜的最后通牒:这就是高手和小白的分水岭!
兄弟盟! 看完这篇拆解,你是不是觉得后背发凉? 你以前用的小龙虾,跟现在这个全副武装、有灵魂、有记忆、有底线的“数字特工”相比,简直就是个残次品!
这套底层文件结构,就是一张“老板与赛博员工的终极协议”。 你把规矩定得越死、越清晰,你以后给它擦屁股的时间就越少,它帮你全自动赚美金、赚人民币的时间就越多!
AGENTS.md 是你最强大的杠杆。搞定它,你就赢了 90% 的同行!
不要再把它当成聊天软件了! 现在!立刻!马上! 打开你的电脑,找到 ~/clawd/ 文件夹(或者你的安装目录),把上面我给你的中文代码模板复制进去! 从小任务开始,建好你的第一层记忆架构。
别再当工具的奴隶,去当驾驭机器人的神!
冲~
以上!
夜雨聆风