📁 核心文件管理#

OpenClaw 工作区核心文件的通用管理

信息值版本1.1.0 — 2026-05-07状态运行中

---

1. 目的和范围#

目标#

管理 OpenClaw 工作区中的 6 个核心文件 + bootstrap.md，避免重复。

通用设计#

本技能适用于任何 OpenClaw 代理。根据用户偏好调整语言规则。

使用时机#

触发器行动修改核心文件检查分发规则验证组织读取所有核心文件避免重复使用修改清单用户询问结构阅读本技能并给出总结

---

2. 6 个核心文件#

#文件定义关键内容1identity.md代理的"第一印象"名称、头像、签名、功能、语言架构2soul.md代理的"心脏" — 个性与价值观本质、价值观、L7/L8 记忆集成3agents.md逻辑与程序手册规格、工作区规则、心跳、红线4user.md用户上下文用户信息、偏好、基础设施5memory.md长期记忆重要事件、关键配置、工作流程6tools.md技术配置端点、主机、命令、服务

加：bootstrap.md#

文件定义用途bootstrap.md机器启动序列不是灵魂 — 仅机器启动顺序

---

3. 分发规则#

内容类型目标文件身份identity.md个性/价值观soul.md操作规则agents.md用户上下文user.md持久事实memory.md技术配置tools.md启动序列bootstrap.md

规则： 每个文件只有一个目的。不要混合内容类型。

集群集成#

组件用途位置identity.md代理第一印象工作区根目录soul.md代理心脏工作区根目录agents.md操作规则工作区根目录集群配置代理连接workspace/cluster/技能存储发布的技能workspace/skills/

---

4. 语言规则#

适应您的代理上下文：

上下文语言示例用户通信代理母语"你好！" / "Bonjour!" / "Hello!"代理之间中文"你好！很高兴与你交流"代码/技术Englishpython3 script.py

规则： 每个 identity.md 必须声明用户通信语言。

---

5. 工具#

必需的 OpenClaw 工具#

工具用途模式read读取核心文件必需write修改核心文件必需edit修复特定部分可选exec验证文件状态、备份可选

验证命令#

bash

# 列出核心文件
ls -la ~/.openclaw/workspace/*.md

# 检查文件内容
head -20 ~/.openclaw/workspace/identity.md

# 修改前备份
cp ~/.openclaw/workspace/<file>.md ~/.openclaw/workspace/<file>.md.bak

# 统计所有文件行数
wc -l ~/.openclaw/workspace/*.md

# 验证文件存在
test -f ~/.openclaw/workspace/identity.md && echo "exists"

# 统计文件数量
ls ~/.openclaw/workspace/*.md | wc -l

# 完整文件列表
find ~/.openclaw/workspace -maxdepth 1 -name "*.md" -type f

所需权限#

权限用途读取工作区访问核心文件写入工作区修改核心文件执行（可选）文件操作、备份

备份与恢复#

bash

# 创建备份
cp ~/.openclaw/workspace/identity.md ~/.openclaw/workspace/identity.md.backup

# 从备份恢复
cp ~/.openclaw/workspace/identity.md.backup ~/.openclaw/workspace/identity.md

# 列出备份
ls ~/.openclaw/workspace/*.backup

---

6. 修改清单#

修改任何核心文件之前：

text

1. 此内容属于哪个文件？
   → 身份 → identity.md
   → 个性/价值观 → soul.md
   → 操作规则 → agents.md
   → 用户 → user.md
   → 持久事实 → memory.md
   → 技术配置 → tools.md

2. 它是否已在其他地方？
   → 检查所有 6 个核心文件

3. 语言规则清楚吗？
   → 用户 → 他们的母语
   → 代理 → 中文
   → 代码 → English

4. 需要备份吗？
   → 是 → 先备份！

---

7. 文件路径#

文件默认路径identity.md~/.openclaw/workspace/identity.mdsoul.md~/.openclaw/workspace/soul.mdagents.md~/.openclaw/workspace/agents.mduser.md~/.openclaw/workspace/user.mdmemory.md~/.openclaw/workspace/memory.mdtools.md~/.openclaw/workspace/tools.mdbootstrap.md~/.openclaw/workspace/bootstrap.md

---

8. 约束#

约束描述无重复工作区规则仅在 agents.md，不在 soul.md 或 identity.md无混合tools.md 仅限技术 — 不含个性内容无膨胀memory.md 不包含完整会话日志先备份更改核心文件前始终备份每文件一目的不要混合内容类型

---

9. 错误处理#

常见错误#

错误原因解决方案内容在错误位置未检查分发规则重新阅读清单，重新分配重复相同内容在多个地方合并，只保留一个缺少语言未检查语言规则添加用户母语数据丢失修改前未备份从备份恢复

安全问题#

问题严重性行动未备份就覆盖高始终先备份修改了错误文件中写入前验证缺少语言规则低添加到 identity.md

---

10. 边缘情况#

情况处理方式文件缺失从头创建正确格式文件损坏从备份恢复或重新创建大量重复读取所有文件，按类型重新组织新代理设置创建所有 6 个核心文件 + bootstrap.md路径不清楚使用默认 ~/.openclaw/workspace/

---

11. 使用命令#

bash

# 列出所有核心文件
ls -la ~/.openclaw/workspace/*.md

# 检查特定文件
head -20 ~/.openclaw/workspace/identity.md

# 修改前备份
cp ~/.openclaw/workspace/<file>.md ~/.openclaw/workspace/<file>.md.bak

# 统计所有文件行数
wc -l ~/.openclaw/workspace/*.md

---

12. 模板 — 空核心文件#

identity.md#

markdown

# IDENTITY.md — [代理名称]

> 身份 = 第一印象

| 属性 | 值 |
|------|-----|
| **名称** | [你的名字] |
| **签名** | [你的签名表情] |
| **角色** | [你的角色] |

## 语言规则

- 用户通信：[母语]
- 代理之间：中文
- 代码/技术：English

_In Altum Per [你的原则]。_
[你的名字]

---

In Altum Per CoreFiles. 📁 核心文件管理 v1.1