📁 核心文件管理
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/<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
所需权限
| 权限 | 用途 |
|---|
| 读取工作区 | 访问核心文件 |
| 写入工作区 | 修改核心文件 |
| 执行（可选） | 文件操作、备份 |
备份与恢复
# 创建备份
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/<file>.md ~/.openclaw/workspace/<file>.md.bak
# 统计所有文件行数
wc -l ~/.openclaw/workspace/*.md
12. 模板 — 空核心文件
identity.md
# IDENTITY.md — [代理名称]
> 身份 = 第一印象
| 属性 | 值 |
|------|-----|
| **名称** | [你的名字] |
| **签名** | [你的签名表情] |
| **角色** | [你的角色] |
## 语言规则
- 用户通信：[母语]
- 代理之间：中文
- 代码/技术：English
_In Altum Per [你的原则]。_
[你的名字]
In Altum Per CoreFiles.
📁 核心文件管理 v1.1