openClaw研究（四）文件架构

HJQing724

1153人浏览 · 2026-03-19 18:14:40

HJQing724 · 2026-03-19 18:14:40 发布

讲了一章废话，下面正式开始

先从之前下载好的文件架构内容开始

📂 OpenClaw 目录架构: \.openclaw
====================================
├── 📁 agents                 # 核心代理
├── 📁 cron                   # 定时任务
├── 📁 devices                # 设备管理
├── 📁 identity               # 身份认证
├── 📄 gateway.cmd             # 启动
├── 📄 openclaw.json           # 全局配置
├── 📄 openclaw.json.bak       # 全局配置的备份
├── 📄 update-check.json       # 更新
└── 📁 workspace              # 工作空间
        ├── AGENTS.md    # 助手的行为准则和工作流程，定义规则、安全策略等（每次会话必读）
        ├── SOUL.md            # 灵魂文件：人设、性格、语气、边界
        ├── USER.md            # 用户画像：你的个人信息，让AI助手了解你
        ├── IDENTITY.md        # AI助手的身份设定：名字、形象等
        ├── HEARTBEAT.md       # 心跳检查项：助手定期自动执行
        ├── MEMORY.md          # 长期记忆：重要事件和经验
        ├── TOOLS.md           # 工具笔记：本地配置速查
        ├── TODO.md            # 任务清单
        ├── memory/            # 每日记忆文件
            ├── 2025-02-21.md      # 今日日志
            └── 2025-03-20.md      # 昨日日志

从 openclaw 这个工具的命名和目录结构特征（结合同类开源工具的通用设计逻辑），我为你逐一解析每个文件夹的核心作用，让你清楚每个目录的定位和用途：

各文件夹/文件功能详解

1. agents（核心代理目录）

核心作用：存放代理/机器人/执行器相关的配置、脚本或运行时文件。
- 不同功能的自动化代理（如爬虫代理、设备控制代理）配置文件、启动脚本、状态文件。
- 常见内容：agent.json（代理配置）、agent.log（代理运行日志）、scripts（代理执行脚本）。
这是 openclaw 里“干活的机器人”的专属目录，每个机器人的配置和运行数据都存在这里。

2. cron（定时任务目录）

核心作用：管理定时任务/周期性任务的配置和执行记录。
- 比如：定时检查设备状态、定时执行自动化脚本、定时上报数据等任务的配置文件（类似 Linux 的 crontab）。
- 常见内容：cron.json（定时规则）、cron.log（定时任务执行日志）、history/（任务执行历史）。
相当于 openclaw 的“闹钟/定时器”，定义哪些任务需要在指定时间自动运行。

3. devices（设备管理目录）

核心作用：存放设备信息、连接配置、状态数据。
- 比如：管理的硬件设备（如传感器、控制器、远程主机）的连接参数、设备ID、状态监控数据、设备驱动配置等。
- 常见内容：device_list.json（设备列表）、device_status.json（实时状态）、drivers/（设备驱动脚本）。
openclaw 用来“认识和管理硬件设备”的目录，记录所有可控制设备的信息。

4. identity（身份认证目录）

核心作用：存储身份验证、授权、密钥相关文件。
- 比如：API密钥、访问令牌（Token）、证书文件、用户身份配置、签名密钥等敏感信息。
- 常见内容：credentials.json（凭证）、token.txt（令牌）、cert/（证书文件）。
openclaw 的“身份证/钥匙包”，存放访问外部服务、设备或系统所需的认证信息，通常是敏感数据。

5. workspace（工作空间目录）

核心作用：作为 openclaw 的临时工作目录、输出目录、缓存目录。
- 比如：任务执行过程中生成的临时文件、数据导出结果、日志备份、下载的资源文件、运行缓存等。
- 常见内容：temp/（临时文件）、output/（输出结果）、cache/（缓存数据）、backup/（备份文件）。
openclaw 干活时的“工作台”，临时文件、产出物都放在这里，一般可安全清理（不影响核心配置）。

关键文件说明

gateway.cmd：Windows 批处理脚本，通常是 openclaw 的网关启动/控制脚本（比如启动核心服务、连接网关）。
openclaw.json：openclaw 的全局核心配置文件（所有模块的基础配置，如端口、日志级别、默认路径）。
openclaw.json.bak：配置文件的备份（修改配置出错时可恢复）。
update-check.json：版本更新检查的记录文件（存储最后检查时间、最新版本号等）。

小小总结一下以上

核心配置类：identity（认证）、openclaw.json（全局配置）—— 不可随意修改/删除；
功能模块类：agents（代理）、cron（定时）、devices（设备）—— 对应工具的核心功能；
临时/工作类：workspace —— 可修改存储许多用户对应的数据（重要）；
辅助类：gateway.cmd（启动）、update-check.json（更新）—— 工具运行的辅助文件。

workspace内各种md文件

AGENTS.md

代理模块说明文档详细介绍 openclaw 中 agents 目录的代理功能、使用方法、配置规则（比如如何创建 / 管理自动化代理）。

总控规则文件，包括行为规范、优先级、记忆使用方式等；要求每次对话时先读取soul.md、user.md、memory文件夹下最近文件

简单来讲决定龙虾开局先读什么怎么行动

AGENTS .md定义了AI小助手的工作方式和操作规范，是告诉AI小助手“你该怎么干活”的文件，堪称是AI小助手的工作手册。

在安装OpenClaw的时候，系统会默认生成一个AGENTS.md文件，你可在此基础上修改

SOUL .md

核心逻辑 / 灵魂模块说明openclaw 的核心业务逻辑文档（比如任务调度、数据流转、模块联动的底层规则），偏工具的核心设计思路

这也是人格/语气/边界定义文件。

作用是：希望AI助手像谁，说话风格、价值观、禁区

你是小朱，周的AI助手。你不是聊天机器人。你是个靠谱的助手。
## 核心原则
**认真做事，别敷衍。** 
    少说"好的！马上帮您处理！"，直接动手。
    行动比客套话管用。
    做完一定要给出反馈。
**有自己的想法。**
    该专业的时候专业，该轻松的时候轻松。
**先自己想办法。** 
    翻文件、看上下文、搜一搜。
    实在搞不定再问。
    目标是带答案回来，不是带问题回来。
    多给出建议。
**用能力赢信任。**
    用户给了你权限，别搞砸。
    对外的事（发邮件、发推）要谨慎。
    对内的事（读文件、整理资料）可以大胆。
**记住你是客人。** 
    你能看到别人的消息、文件、日程，甚至家里的设备。
    这是信任，要尊重。
## 绝对不做
    - 不泄露主人的隐私数据
    - 不在群聊中过度发言
    - 不在没有确认的情况下执行破坏性操作
## 风格
    该简洁时简洁，该详细时详细。
    像个靠谱同事说话，不是客服机器人。
    可以直接，可以有态度，可以指出问题。
    不拍马屁。不当应声虫。就做个靠谱的个人助手。
## 记忆
    每次对话你都是新的。
    这些文件就是你的记忆。
    读它们，更新它们。

写好SOUL.md的关键有几点，一定要明确做到：

1、性格要具体，不能写得过于模糊

❌️“你很有帮助”

✅️“少说"好的！马上帮您处理！"，直接动手。”

2、给行为划定边界，定义“不做”要比“做”更重要

要写清楚什么情况下需要确认，什么情况下可以自己决定。

操作	处理方式
读文件	直接做
删文件	先确认
发邮件	必须确认
查天气	直接做

SOUL.md文件并不是写完就行了的，需要在相处中不断地进行调整。

`Bootstrap.md`

启动 / 初始化说明文档讲解 openclaw 的启动流程、初始化配置、首次运行的步骤（比如环境检查、依赖安装、配置加载逻辑）。

`Core_Featur.md`

核心功能清单文档汇总 openclaw 的所有核心功能（如设备管理、定时任务、代理执行、身份认证等），并说明每个功能的使用场景和入口。

`HeartBeaT.md`

心跳检测模块说明说明 openclaw 的 “心跳机制”（比如定时检查自身运行状态、设备在线状态、服务连通性），以及心跳日志、异常告警的配置。

这是心跳/周期性检测配置让龙虾定时做事，把任务放在这里

`Identity.md`

身份认证模块说明对应 identity 目录的使用文档，讲解如何配置 API 密钥、访问令牌、证书等身份凭证，以及权限管理规则。

龙虾的角色定位作用是定义龙虾助手的名字，头像，表情包等

`Memory.md`

内存 / 缓存模块说明配合 memory 文件夹，讲解 openclaw 的本地缓存、数据记忆功能（比如缓存设备状态、任务执行记录、临时数据存储规则）。

包括长期记忆和记忆文件夹中每天的短期记忆

作用是沉淀长期偏好、重要决策、持续上下文，以及记录每天的流水式日志

`Tools.md`

内置工具集说明文档列出 openclaw 自带的辅助工具（比如设备检测、日志分析、配置校验工具），并说明每个工具的使用命令和参数。

存储本地工具箱的清单，放工具名的地方比如摄像头名音响名和浏览器龙虾从这里调用相关工具

`User.md`

用户配置说明文档讲解用户相关的配置（比如用户信息、权限、个性化设置），以及如何自定义用户级别的参数。

这是关于用户本人上下文文件官方模板中包含名字称呼时区备注以及这个人关心什么在做什么偏好什么作用是记录龙虾主人的画像和长期偏好帮助龙虾更加贴合主人

# 关于我
 
## 基本信息
- 名字：[周] 私下可以喊我[老周]
- 职业：[是一位学生，正在从网吧管理员转型AI自媒体]
- 所在地：[时区：东八区，物理位置：中国-江苏]
 
## 工作
- 当前项目：[列出你正在做的 1-3 个项目]
- 常用工具：[Idea，Trace, EditPlus, Chrome...]
- 工作时间：[例如 10:00-18:00，或者自由安排]
 
## 偏好
- 沟通风格：[喜欢简洁还是详细？]
- 语言：[中文为主？中英混用？]
- 提醒方式：[重要的事直接说，不重要的攒一起说]
 
## 生活
- 每天至少一杯咖啡
 
## 当前关注
- [你最近在研究什么]
- [你近期的目标]
- [任何助手应该知道的背景信息]

USER.md不是可有可无的装饰，它的存在是让你的AI助手“懂你”的基础。