OpenClaw 刚装好时,很多文件默认都在 ~/.openclaw/ 下面。
这样做当然方便,安装完几乎不用折腾,直接就能跑起来。
但只要你开始认真使用,很快就会遇到一个问题:系统文件、Agent 文件、文章草稿、代码项目,如果全堆在一起,后面一定会越来越乱。
所以更适合长期使用的办法,不是把所有东西都塞进 ~/.openclaw/,而是把系统运行目录和实际工作目录拆开。
一、OpenClaw 默认结构是什么
OpenClaw 默认的核心目录通常是:~/.openclaw/。
这里更像是 OpenClaw 的系统层,常见内容包括:
openclaw.json:主配置文件 agents/:智能体相关数据 workspace/:默认工作区 credentials/:认证信息 devices/:设备配对信息 cron/:定时任务 identity/:身份相关文件 日志和运行状态相关内容
如果只是短期体验,这种默认结构没什么问题;但如果你已经开始把 OpenClaw 当成日常工作的一部分,这种结构就不够清晰了。
二、为什么要重新整理工作目录
原因其实很直接:
系统配置和业务文件混在一起,不好找 Agent 的长期记忆和临时测试文件容易打架 文章、代码、项目资料全堆在一个目录里,越用越乱 后面要迁移、备份、用 Git 管理时,边界不清楚会很难受
所以更推荐的做法,是把真正做事的内容统一放到 ~/workspace/ 下面,然后按用途分目录。
我现在更推荐这样的结构:
~/workspace/agent-main~/workspace/mp-articles~/workspace/code-projectxxx其他项目也按用途继续放在 ~/workspace/下
三、为什么 agent-main 要单独拿出来
这里有个特别重要的点:Agent 本身,也应该被当成一个项目来管理。
很多人一开始会觉得,Agent 不过是几份提示词、几份配置文件,但实际用久了就会发现并不是这样。
一个主 Agent 往往会逐渐形成自己的:
行为规则 记忆文件 用户偏好 工具说明 工作习惯 持续演化的版本历史
所以 ~/workspace/agent-main 不是一个随手放文件的目录,而是主 Agent 这个项目的根目录。
这里通常适合放:
AGENTS.mdSOUL.mdUSER.mdTOOLS.mdIDENTITY.mdHEARTBEAT.mdMEMORY.mdmemory/
换句话说,Agent 也应该像代码项目一样被认真维护。
四、为什么内容和代码也要分开
像公众号文章这种内容型资产,很适合独立放到 ~/workspace/mp-articles。
这样做的好处也很直接:
草稿集中,方便检索 不会和 Agent 系统文件混在一起 方便后续做专题、系列和归档 后面无论是润色、排期还是复用素材,都更顺手
代码项目同样建议继续拆开,比如:
~/workspace/code-project-openclaw-tools~/workspace/code-project-website~/workspace/code-project-demo
名字怎么取其实没那么重要,重要的是别和 Agent 文件、文章文件混在一起。代码归代码,内容归内容,Agent 归 Agent,这样后面管理起来会轻松很多。
而且这套结构还有一个很实际的好处:每个目录都可以单独做 Git 管理。
agent-main单独一个仓库 mp-articles单独一个仓库 每个代码项目也各自一个仓库
这样做之后,修改历史更清楚,不同项目互不污染,备份和迁移也更方便。
五、最后再啰嗦一嘴
如果你只是想先试试 OpenClaw,默认目录当然够用。
但如果你准备长期用,最好还是尽早把目录结构整理清楚。
我的建议很简单:
~/.openclaw/留给系统运行 ~/workspace/agent-main留给主 Agent ~/workspace/mp-articles留给公众号文章 ~/workspace/code-projectxxx留给代码项目 其他内容也继续按用途拆分
这样做不是为了“显得专业”,而是为了以后不乱。
等你手头的东西越来越多,就会发现:真正省心的,从来不是某个高级配置,而是你一开始就把工作区收拾明白了。
夜雨聆风