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.md
  • SOUL.md
  • USER.md
  • TOOLS.md
  • IDENTITY.md
  • HEARTBEAT.md
  • MEMORY.md
  • memory/

换句话说，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 留给代码项目
  • 其他内容也继续按用途拆分

这样做不是为了“显得专业”，而是为了以后不乱。

等你手头的东西越来越多，就会发现：真正省心的，从来不是某个高级配置，而是你一开始就把工作区收拾明白了。