Core Files Management — 核心文件管理

CORE 文件管理 📁 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 运营规则 工作空间根目录 集群配置 代理连接 工作空间/集群/技能存储 已发布技能 工作空间/技能/

• 语言规则

适应代理的上下文： 上下文 语言 示例 用户通信 代理的母语 “Bonjour！” / “Hello！” / “你好！” 代理之间 中文 “你好！很高兴与你交流” 代码/技术 英语 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个核心文件

• 语言规则是否明确？

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

• 是否需要备份？

→ 是 → 首先备份！

• 文件路径

文件 默认路径 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

• 边缘情况

情况 处理 文件缺失 从头开始创建具有正确格式的文件 文件损坏 从备份中恢复