📁 核心文件管理
功能概述
📁 核心文件管理是一项面向实际任务的技能,主要用于OpenClaw 工作区核心文件的通用管理;1.1.0 — 2026-05-07;
核心要点
- 1. 目的和范围;
- 管理 OpenClaw 工作区中的 6 个核心文件 + bootstrap.md,避免重复;
- 本技能适用于任何 OpenClaw 代理;
使用与执行
根据用户偏好调整语言规则;修改核心文件;检查分发规则;读取所有核心文件;使用修改清单;用户询问结构。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
结果检查与注意事项
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
📁 核心文件管理
OpenClaw 工作区核心文件的通用管理
| 信息 |
值 |
| 版本 |
1.1.0 — 2026-05-07 |
| 状态 |
运行中 |
1. 目的和范围
目标
管理 OpenClaw 工作区中的 6 个核心文件 + bootstrap.md,避免重复。
通用设计
本技能适用于任何 OpenClaw 代理。根据用户偏好调整语言规则。
使用时机
| 触发器 |
行动 |
| 修改核心文件 |
检查分发规则 |
| 验证组织 |
读取所有核心文件 |
| 避免重复 |
使用修改清单 |
| 用户询问结构 |
阅读本技能并给出总结 |
2. 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 |
机器启动序列 |
不是灵魂 — 仅机器启动顺序 |
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!" |
| 代理之间 |
中文 |
"你好!很高兴与你交流" |
| 代码/技术 |
English |
python3 script.py |
规则: 每个 identity.md 必须声明用户通信语言。
5. 工具
必需的 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
6. 修改清单
修改任何核心文件之前:
1. 此内容属于哪个文件?
→ 身份 → identity.md
→ 个性/价值观 → soul.md
→ 操作规则 → agents.md
→ 用户 → user.md
→ 持久事实 → memory.md
→ 技术配置 → tools.md
2. 它是否已在其他地方?
→ 检查所有 6 个核心文件
3. 语言规则清楚吗?
→ 用户 → 他们的母语
→ 代理 → 中文
→ 代码 → English
4. 需要备份吗?
→ 是 → 先备份!
7. 文件路径
| 文件 |
默认路径 |
| 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 |
8. 约束
| 约束 |
描述 |
| 无重复 |
工作区规则仅在 agents.md,不在 soul.md 或 identity.md |
| 无混合 |
tools.md 仅限技术 — 不含个性内容 |
| 无膨胀 |
memory.md 不包含完整会话日志 |
| 先备份 |
更改核心文件前始终备份 |
| 每文件一目的 |
不要混合内容类型 |
9. 错误处理
常见错误
| 错误 |
原因 |
解决方案 |
| 内容在错误位置 |
未检查分发规则 |
重新阅读清单,重新分配 |
| 重复 |
相同内容在多个地方 |
合并,只保留一个 |
| 缺少语言 |
未检查语言规则 |
添加用户母语 |
| 数据丢失 |
修改前未备份 |
从备份恢复 |
安全问题
| 问题 |
严重性 |
行动 |
| 未备份就覆盖 |
高 |
始终先备份 |
| 修改了错误文件 |
中 |
写入前验证 |
| 缺少语言规则 |
低 |
添加到 identity.md |
10. 边缘情况
| 情况 |
处理方式 |
| 文件缺失 |
从头创建正确格式 |
| 文件损坏 |
从备份恢复或重新创建 |
| 大量重复 |
读取所有文件,按类型重新组织 |
| 新代理设置 |
创建所有 6 个核心文件 + bootstrap.md |
| 路径不清楚 |
使用默认 ~/.openclaw/workspace/ |
11. 使用命令
# 列出所有核心文件
ls -la ~/.openclaw/workspace/*.md
# 检查特定文件
head -20 ~/.openclaw/workspace/identity.md
# 修改前备份
cp ~/.openclaw/workspace/.md ~/.openclaw/workspace/.md.bak
# 统计所有文件行数
wc -l ~/.openclaw/workspace/*.md
12. 模板 — 空核心文件
identity.md
# IDENTITY.md — [代理名称]
> 身份 = 第一印象
| 属性 | 值 |
|------|-----|
| **名称** | [你的名字] |
| **签名** | [你的签名表情] |
| **角色** | [你的角色] |
## 语言规则
- 用户通信:[母语]
- 代理之间:中文
- 代码/技术:English
_In Altum Per [你的原则]。_
[你的名字]
In Altum Per CoreFiles.
📁 核心文件管理 v1.1