技能介绍

问题的起点：工作空间不是配置文件

OpenClaw 的工作空间文件是 agent 的"灵魂与记忆"，每一轮（或相关轮次）都会被注入 system prompt，承载身份、行为规则、环境知识和长期记忆。问题在于这些文件会持续累积：膨胀浪费 token，冗余让 agent 在不同规则之间摇摆，过期内容直接导致错误决策。单个文件上限 20,000 字符，所有 bootstrap 文件合计约 150,000 字符，超限的后果不是报错，而是被静默截断。

这个技能做什么

核心是四套可复用的 workflow：

审计现有工作空间：通读 AGENTS.md、SOUL.md、TOOLS.md、USER.md、IDENTITY.md、HEARTBEAT.md、BOOT.md、MEMORY.md，统计字符数，标记超过 10,000 字符的文件，然后排查冗余（同一事实同时出现在 SOUL.md 和 AGENTS.md）、过期内容（失效的 SSH 主机、旧工具名、已废弃的规则）以及 MEMORY.md 的纪律性。
从零搭建新工作空间：给出有先后顺序的创建清单，先 SOUL.md 再 AGENTS.md，因为启动序列依赖身份先确立。最小可用集合只有三个文件：AGENTS.md + SOUL.md + TOOLS.md。BOOTSTRAP.md 必须在文件末尾写明自删除指令。
记忆蒸馏：周期性把 memory/YYYY-MM-DD.md 日志中反复违反的规则、未沉淀到 skill 文档的硬发现、必须常驻上下文的环境事实晋升进 MEMORY.md，用铁律格式书写，同时把超过 30 天的日志归档或删除。
维护工具笔记与检查清单：TOOLS.md 只放本机特有的速查信息；checklists/*.md 一旦超过约 50 行，说明它想当文档，叙事部分应挪到 docs/。

踩坑点与边界

MEMORY.md 含私有上下文，绝不能在群聊或子 agent 会话中加载。AGENTS.md 里的加载步骤必须显式判断会话类型。
agent 不会自动加载文件，它只按 AGENTS.md 启动序列里的指令去读。启动序列漏写文件名，就是最常见的"改了没生效"。
工作空间文件在会话开始时读取，改动后需要重启 gateway 或新开会话。
docs/ 不被自动加载，适合放详细参考。
各文件的设计原则与反模式见 references/workspace-files.md，token 优化策略见 references/optimization-guide.md。