📦 中文 核心文件管理 — 核心文件管理（Core File Management）

📁 核心文件管理 OpenClaw 工作区核心文件的通用管理 信息 值 版本 1.1.0 — 2026-05-07 状态 运行中

• 目的和范围

目标 管理 OpenClaw 工作区中的 6 个核心文件 + bootstrap.md，避免重复。 通用设计 本技能适用于任何 OpenClaw 代理。根据用户偏好调整语言规则。 使用时机 触发器 行动 修改核心文件 检查分发规则 验证组织 读取所有核心文件 避免重复 使用修改清单 用户询问结构 阅读本技能并给出总结

• 6 个核心文件

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

• 分发规则

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

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

• 语言规则

适应您的代理上下文： 上下文 语言 示例 用户通信 代理母语 "你好！" / "Bonjour!" / "Hello!" 代理之间 中文 "你好！很高兴与你交流" 代码/技术 English python3 script.py 规则： 每个 identity.md 必须声明用户通信语言。

• 工具

必需的 OpenClaw 工具 工具 用途 模式 read 读取核心文件 必需 write 修改核心文件 必需 edit 修复特定部分 可选 exec 验证文件状态、备份 可选 验证命令 # 列出核心文件 ls -la ~/.openclaw/workspace/.md # 检查文件内容 head -20 ~/.openclaw/workspace/identity.md # 修改前备份 cp ~/.openclaw/workspace/.md ~/.openclaw/workspace/.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

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

备份与恢复 # 创建备份 cp ~/.openclaw/workspace/identity.md ~/.openclaw/workspace/identity.md.backup # 从备份恢复 cp ~/.openclaw/workspace/identity.md.backup ~/.openclaw/workspace/identity.md # 列出备份 ls ~/.openclaw/workspace/.backup

• 修改清单

修改任何核心文件之前：

• 此内容属于哪个文件？

→ 身份 → identity.md → 个性/价值观 → soul.md → 操作规则 → agents.md → 用户 → user.md → 持久事实 → memory.md → 技术配置 → tools.md

• 它是否已在其他地方？

→ 检查所有 6 个核心文件

• 语言规则清楚吗？

→ 用户 → 他们的母语 → 代理 → 中文 → 代码 → English

• 需要备份吗？

→ 是 → 先备份！

• 文件路径

文件 默认路径 identity.md ~/.openclaw/workspace/identity.md soul.md ~/.openclaw/workspace/soul.md agents.md ~/.openclaw/workspace/agents.md user.md ~/.openclaw/workspace/user.md memory.md ~/.openclaw/workspace/memory.md tools.md ~/.openclaw/workspace/tools.md bootstrap.md ~/.openclaw/workspace/bootstrap.md

• 约束

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

• 错误处理

常见错误 错误 原因 解决方案 内容在错误位置 未检查分发规则 重新阅读清单，重新分配 重复 相同内容在多个地方 合并，只保留一个 缺少语言 未检查语言规则 添加用户母语 数据丢失 修改前未备份 从备份恢复 安全问题 问题 严重性 行动 未备份就覆盖 高 始终先备份 修改了错误文件 中 写入前验证 缺少语言规则 低 添加到 identity.md

• 边缘情况

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

• 使用命令

# 列出所有核心文件 ls -la ~/.openclaw/workspace/.md # 检查特定文件 head -20 ~/.openclaw/workspace/identity.md # 修改前备份 cp ~/.openclaw/workspace/.md ~/.openclaw/workspace/.md.bak # 统计所有文件行数 wc -l ~/.openclaw/workspace/*.md

• 模板 — 空核心文件

identity.md # IDENTITY.md — [代理名称]

身份 = 第一印象 | 属性 | 值 |

|------|-----| | 名称 | [你的名字] | | 签名 | [你的签名表情] | | 角色 | [你的角色] |

语言规则

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

_In Altum Per [你的原则]。_ [你的名字] In Altum Per CoreFiles. 📁 核心文件管理 v1.1