OpenClaw 工作区管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/openclaw-workspace-mslf。
技能介绍
解决什么问题
OpenClaw 的 workspace 文件承担着 Agent 的“身份”与“长期记忆”:它们会被注入 system prompt,告诉 Agent 自己是谁、有哪些行为规则、运行环境长什么样。这类文件一旦失控,代价很直接——体积膨胀会吃掉大量 token,内容重复会让 Agent 行为不一致,过时信息则可能导致它在错误的上下文里做决策。
这个技能要处理三类典型问题:单个 bootstrap 文件逼近 20,000 字符上限而被截断、MEMORY.md 越写越长导致每次读取都浪费上下文、以及私密记忆被错误加载到群聊或 sub-agent 会话中。
核心能力与关键步骤
技能围绕几个明确场景组织工作流:
- 审计现有 workspace:逐项读取
AGENTS.md、SOUL.md、TOOLS.md、USER.md、IDENTITY.md、HEARTBEAT.md、BOOT.md、MEMORY.md,统计字符数,标记超过10,000字符的文件,检查跨文件冗余、过时的工具名和规则,并区分哪些内容应该留在 bootstrap 文件里、哪些应该移到按需加载的docs/目录。 - 搭建新 workspace:按固定顺序创建文件,先写
SOUL.md确定人格与价值观,再写AGENTS.md定义启动序列和安全规则,然后补充IDENTITY.md、USER.md、TOOLS.md、MEMORY.md,最后按需添加HEARTBEAT.md、BOOT.md与一次性的BOOTSTRAP.md。最简可行组合只需要AGENTS.md、SOUL.md、TOOLS.md三个文件。 - 记忆蒸馏:定期把
memory/YYYY-MM-DD.md中反复出现的教训、环境事实和高优先级规则提炼成简洁的“铁律”写入MEMORY.md,同时把超过 30 天的日志归档或删除,避免MEMORY.md无限膨胀。 - 维护 checklists 与 TOOLS.md:为高风险操作编写结构化检查清单,在
AGENTS.md的 checklists 表中登记;TOOLS.md只放这台机器特有的环境速查,如 SSH 主机、TTS 提供商、摄像头 ID。
适用边界与注意点
所有 bootstrap 文件的总预算约为 150,000 字符,单个文件上限 20,000 字符,超限会被截断。MEMORY.md 的隐私红线是硬约束:绝不能在群聊或 sub-agent 会话中加载。另外,文件是在会话启动时按 AGENTS.md 的 boot sequence 读取的,改完文件后需要重启 gateway 或开启新会话才会生效,不是实时热更新。
使用场景
- 新建 OpenClaw Agent 时,按 SOUL、AGENTS、IDENTITY 顺序初始化最小可用的 workspace。
- 发现 Agent 回复开始变慢或偏离规则时,逐项审计 workspace 文件,找出冗余、过时和超限内容。
- 把超过 30 天的每日日志归档,把反复出现的教训提炼进 MEMORY.md,保持长期记忆精简。
- 为部署新的 TTS 服务或摄像头做高风险操作前,更新 TOOLS.md 并在 AGENTS.md 登记 checklist。
适合人员
- 正在为单个 OpenClaw Agent 搭建身份、规则和长期记忆文件的开发者。
- 已经上线多个 Agent,需要定期检查 workspace 是否膨胀或泄露隐私的维护人员。
- 负责整理 Agent 行为文档,希望把 checklists 和环境笔记拆到合适位置的技术写作者。
- 需要为团队制定 Agent 上线前 workspace 配置与审计规范的基础设施工程师。