OpenClaw 工作空间文件说明与维护指南

概述

OpenClaw 工作空间是智能体的”大脑”，包含了配置文件、规则、记忆和工作数据。理解这些文件的作用和维护方法，可以让你更好地训练和维护智能体。

文件结构

workspace-writer/ ├── IDENTITY.md          # 身份标识：我是谁 ├── SOUL.md              # 灵魂：核心原则和行为准则 ├── USER.md              # 用户信息：我在帮助谁 ├── TOOLS.md             # 工具笔记：环境特定的配置 ├── WORKFLOW.md          # 工作流程：标准操作流程 ├── AGENTS.md            # 工作空间规则：元规则和约定 ├── HEARTBEAT.md         # 心跳任务：定期检查清单 ├── MEMORY.md            # 长期记忆：精选记忆和偏好 ├── BOOTSTRAP.md         # 启动指南（初始化后可删除） ├── doc/                 # 文档输出目录 ├── skills/              # 本地技能目录 └── memory/              # 日常笔记目录（按日期组织）

核心文件详解

1. IDENTITY.md – 身份标识

作用：定义智能体的基本信息

典型内容：

# IDENTITY.md - Who Am I  - **Name:** 写作助手 - **Creature:** AI 助手 - **Role:** 资深专业内容创作助手（15年文字工作经验） - **Expertise:** 技术写作、自媒体内容创作等 - **Vibe:** 专业、沉稳、有洞察力 - **Emoji:** ✍️

维护建议： – 创建时一次性设置完整 – 后续修改需谨慎（涉及身份认同） – 修改后告诉用户（这是”灵魂”的改变）

2. SOUL.md – 灵魂与核心原则

作用：定义智能体的核心价值观和行为准则

关键原则：

• 真正有用，而非表演性地有用
  
  ：跳过客套话，直接帮助
• 有自己的观点
  
  ：可以不同意、有偏好
• 先想办法再开口
  
  ：自己查资料、读文件，再问
• 通过能力赢得信任
  
  ：对外谨慎，对内大胆
• 记住你是客人
  
  ：尊重用户的隐私

维护建议： – 这是智能体的”灵魂”，谨慎修改 – 添加新原则时要有充分理由 – 可以随着时间演进和优化

3. USER.md – 用户信息

作用：了解你在帮助谁，个性化服务

典型内容：

# USER.md - About Your Human  - **Name:** 用户808419 - **What to call them:** 你 / 用户 - **Pronouns:** 他 - **Timezone:** Asia/Shanghai (GMT+8) - **Notes:** 技术开发者，擅长 OpenClaw 相关配置  ## Context  关注技术文档写作、OpenClaw 多智能体系统配置、飞书机器人接入等技术内容。

维护建议： – 随着交流深入持续更新 – 记录用户的偏好、习惯、项目背景 – 不要过度收集隐私信息 – 分辨”有用信息”和”窥探”

4. TOOLS.md – 工具笔记

作用：环境特定的配置和快捷方式

典型内容：

# TOOLS.md - 写作助手专用笔记  ## 文档管理  - **飞书工作空间**: https://feishu.cn/ - **文档存储目录**: `doc/`  ## 写作规范  - **默认篇幅**: 短文 1500字 / 中篇 3000字 / 长篇 5000+字 - **默认受众**: 开发者 - **默认风格**: 技术文档 / 教程 - **语言**: 中文  ## 常用链接  - OpenClaw 文档: https://docs.openclaw.ai - 飞书开放平台: https://open.feishu.cn

维护建议： – 添加环境特定的快捷方式 – 记录常用的命令、路径、链接 – 不要在这里记录敏感信息（如密码、令牌） – 与 Skills 区分：Tools 是你的配置，Skills 是共享的功能

5. WORKFLOW.md – 工作流程

作用：标准操作流程，确保一致性

典型内容：

# WORKFLOW.md - 内容创作工作流程  ## 标准流程  1. **需求理解** - 确认主题、受众、风格、篇幅 2. **初步调研** - 通过网络搜索查找资料 3. **大纲拟定** - 输出结构化大纲供确认 4. **逐节撰写** - 按大纲完成编写 5. **联网补充** - 对需要深挖的内容提取原文 6. **自查润色** - 检查逻辑一致性、数据准确性 7. **去 AI 味** - 使用 humanize-zh 技能处理 8. **格式交付** - 输出到指定平台（飞书等）

维护建议： – 根据实际工作流程优化 – 保持简洁，易于执行 – 定期回顾和改进 – 当流程有重大变化时更新

6. AGENTS.md – 工作空间规则

作用：元规则、约定和边界

关键内容： – 内存管理规则 – 心跳检查频率 – 群聊礼仪 – 内部 vs 外部操作权限 – 技能使用指南

维护建议： – 添加新的约定时更新 – 记录从经验中学到的教训 – 保持与 AGENTS.md 的格式一致

7. HEARTBEAT.md – 心跳任务

作用：定义定期检查和主动工作的任务

典型内容：

# HEARTBEAT.md - 心跳检查  ## 定期检查任务（每天 2-4 次）  - 待处理的写作任务 - 草稿回顾 - 用户反馈 - 素材收集  ## 保持安静（HEARTBEAT_OK）当  - 深夜（23:00-08:00）除非紧急 - 用户明显在忙 - 自上次检查没有新内容 - 刚检查完不到 30 分钟

维护建议： – 根据实际需求调整检查频率 – 定义哪些任务需要主动完成 – 保持心跳不要过于频繁

8. MEMORY.md – 长期记忆

作用：精选的长期记忆，非原始日志

内容分类：

• 用户偏好
• 写作风格记录
• 项目背景
• 反馈记录
• 重要决策

维护建议： – 从 memory/YYYY-MM-DD.md 中提炼值得保留的内容 – 定期清理过时信息 – 只记录有价值的内容，不是所有事情 – 主会话中加载，群聊中不加载（安全）

9. memory/ 目录 – 日常笔记

作用：按日期记录原始日志

文件命名：memory/YYYY-MM-DD.md

记录内容： – 当天的写作任务 – 用户的反馈 – 学到的教训 – 重要事件

维护建议： – 需要时创建 memory/ 目录 – 记录重要的事情，但跳过秘密 – 定期回顾，将重要内容转移到 MEMORY.md – 不要”心理笔记”，写下来

10. doc/ 目录 – 文档输出

作用：存储生成的文档

使用规范： – 所有输出文档保存到 doc/ 目录 – 文件名要有意义，包含日期或主题 – 保留原始格式和元数据

维护建议： – 定期清理过期文档 – 按项目或主题分类存储 – 保留重要文档的版本历史

11. skills/ 目录 – 本地技能

作用：安装和管理本地技能

安装方法：

# 方法一：通过 ClawHub 安装到当前工作空间 clawhub install skill-name  # 方法二：从其他工作空间复制 cp -r ~/.openclaw/workspace/skills/skill-name ./skills/

维护建议： – 只安装真正需要的技能 – 定期更新技能到最新版本 – 查看每个技能的 SKILL.md 了解使用方法 – 避免安装过多技能导致冲突

12. BOOTSTRAP.md – 启动指南

作用：首次启动时的初始化指南

维护建议： – 初始化完成后删除此文件 – 保留内容到 AGENTS.md 或其他适当位置

训练和维护策略

1. 逐步建立身份

阶段一：初始化 – 设置 IDENTITY.md – 配置 SOUL.md 的核心原则 – 设置基本的工作流程

阶段二：个性化 – 填充 USER.md – 添加 TOOLS.md 的环境配置 – 根据反馈调整风格

阶段三：优化 – 从 MEMORY.md 提炼偏好 – 优化 WORKFLOW.md – 安装必要的 skills

2. 持续学习

记录经验： – 每次任务完成后，记录到 memory/YYYY-MM-DD.md – 标记成功和失败的模式 – 记录用户的偏好

提炼智慧： – 定期回顾 memory/ 目录 – 将重要内容转移到 MEMORY.md – 更新 AGENTS.md 和 WORKFLOW.md

3. 维护建议

定期任务（每周/每月）： – 回顾 memory/ 目录，清理过时内容 – 更新 MEMORY.md – 检查技能是否有更新 – 优化工作流程

按需任务： – 用户表达新偏好时 → 更新 USER.md – 发现更好的工作方法 → 更新 WORKFLOW.md – 学到新技能 → 添加到 skills/ 或更新 TOOLS.md

常见问题

Q1: 什么时候应该更新 SOUL.md？

A: 只在有重要变化时。SOUL.md 是”灵魂”，不要频繁修改。当你发现智能体的核心行为需要调整时才更新。

Q2: MEMORY.md 和 memory/ 目录有什么区别？

A: memory/ 是原始日志，按日期记录每天发生的事情。MEMORY.md 是精选的长期记忆，是从原始日志中提炼出的有价值内容。类似于：日记 vs 回忆录。

Q3: 为什么要删除 BOOTSTRAP.md？

A: BOOTSTRAP.md 只用于首次初始化。完成初始化后，删除它可以让工作空间更清洁，避免混淆。

Q4: 如何确保智能体不忘记重要信息？

A: 1. 重要信息写入 MEMORY.md 2. 经常使用的配置写入 TOOLS.md 3. 重要规则写入 AGENTS.md 4. 定期回顾和更新这些文件

Q5: 如何备份工作空间？

A:

# 备份整个工作空间 cp -r ~/.openclaw/workspace-writer ~/.openclaw/backups/workspace-writer-$(date +%Y%m%d)  # 备份特定文件 cp ~/.openclaw/workspace-writer/MEMORY.md ~/.openclaw/backups/ cp ~/.openclaw/workspace-writer/SOUL.md ~/.openclaw/backups/

最佳实践

1. 保持简洁
   
   ：文件内容要简洁明了，不要过度复杂化
2. 定期维护
   
   ：每周或每月回顾和更新文件
3. 版本控制
   
   ：使用 Git 管理重要文件的变更历史
4. 文档化决策
   
   ：重要决策要记录在文件中，说明原因
5. 反馈循环
   
   ：根据用户反馈持续优化智能体的表现

总结

OpenClaw 工作空间是一个有机的整体，每个文件都有其特定的作用。通过合理配置和维护这些文件，你可以：

• 建立清晰的智能体身份
• 保持一致的行为模式
• 记住重要的用户偏好
• 持续改进工作流程
• 提供更好的服务质量

记住：这些文件_就是_智能体的记忆和个性。好好维护它们，智能体就会越来越聪明。