在前面的文章中，我们已经完成了：

• 环境搭建
• 安装 OpenClaw
• 解决常见问题

接下来，我们要进入一个非常关键但经常被忽略的部分：

理解 OpenClaw 的目录结构。

很多人一上来就直接用，但一旦遇到问题，比如：

• 为什么任务执行失败？
• 为什么修改没有生效？
• 为什么行为和预期不一致？

就会完全没有头绪。

原因很简单：

不知道 OpenClaw 在“哪里做了什么”。

这一篇，我们就把它的目录结构讲清楚，让你知道：

👉 它是怎么工作的

👉 数据放在哪

👉 任务是怎么运行的

一、先说结论：OpenClaw 本质是“围绕目录运行”的

和很多工具不一样，OpenClaw 的运行核心不是某个界面，而是：

当前工作目录（workspace）

你在哪个目录运行 OpenClaw，它就会：

• 读取这个目录
• 分析代码
• 修改文件
• 执行任务

所以可以这么理解：

目录 = OpenClaw 的“工作空间”

二、一个典型的目录结构

在实际使用中，一个项目目录大概会是这样：

project/├── src/├── package.json├── README.md├── .env├── .openclaw/

重点在最后这个：

👉 .openclaw 目录

三、.openclaw 目录是干什么的

这是 OpenClaw 的核心目录。

你可以理解为：

OpenClaw 的“运行记录 + 配置中心”

里面通常会包含：

• 配置文件
• 任务记录
• 执行日志
• 缓存数据

四、.openclaw 目录内部结构（核心理解）

不同版本可能略有差异，但大致会包含这些内容：

.openclaw/├── config/├── tasks/├── logs/├── cache/

我们一个一个讲。

1 config（配置）

这里放的是：

• 模型配置
• Agent 配置
• 运行参数

例如：

• 使用哪个模型
• 最大执行步数
• 行为策略

👉 如果你想“控制 OpenClaw 怎么做事”，通常就在这里调整。

2 tasks（任务）

这里记录的是：

每一次任务的执行过程

例如：

• 任务输入
• 拆分步骤
• 执行结果

👉 你可以在这里看到：OpenClaw 是怎么一步一步完成任务的

这对于排查问题非常有用。

3 logs（日志）

这里是：

运行日志

包括：

• 报错信息
• 执行过程
• 调用记录

如果你遇到问题，比如：

• 执行失败
• 行为异常

👉 第一时间应该看这里。

4 cache（缓存）

这里存放：

• 中间结果
• 模型返回内容
• 临时数据

作用是：👉 提高执行效率，减少重复调用模型

一般不需要手动修改。

五、除了 .openclaw，还有哪些关键文件

除了这个目录，还有几个文件你需要注意。

1 .env（环境变量）

用于配置：

• API Key
• 模型参数

例如：

OPENAI_API_KEY=xxx

👉 这是模型能否正常工作的关键。

2 项目代码目录（src / app 等）

这是 OpenClaw 实际操作的对象。

例如：

• 读取代码
• 修改文件
• 重构模块

👉 所有“改代码”的操作，都是在这里发生的。

3 README / 文档文件

OpenClaw 在分析项目时，通常也会读取这些内容。

👉 有时候文档越清晰，AI 的理解会越准确。

六、一个关键理解：OpenClaw 是“读-改-写”的过程

理解目录结构之后，你可以把 OpenClaw 的工作方式简化为：

1 读取

• 读取项目文件
• 分析结构

2 处理

• 调用模型
• 拆分任务
• 生成方案

3 写入

• 修改代码
• 生成文件
• 输出结果

而这些过程：

👉 都会在 .openclaw 目录中留下记录

七、为什么你一定要了解这些

很多人觉得：

“我只用，不需要懂这些”

但实际情况是：

当你遇到这些问题时：

• 为什么改了一半停了？
• 为什么改错文件？
• 为什么执行逻辑奇怪？

如果你不了解目录结构：

👉 你是没法排查的

八、一个实用建议（很重要）

如果你在做重要任务，比如：

• 批量改代码
• 重构项目

建议你：

定期查看 .openclaw/tasks 和 logs

你会发现：

• 它是怎么思考的
• 哪一步出了问题

这对提升使用效果非常有帮助。

九、小结

这一篇我们讲清楚了三件事：

1 OpenClaw 是围绕目录运行的

2 .openclaw 是核心运行目录

3 tasks / logs 是排查问题的关键

一句话总结：

想用好 OpenClaw，必须知道它“在哪里做了什么”。