工作空间审查

一个自我审计流程，用于验证工作空间文件是否遵循OpenClaw约定，且未偏离为标准模式。

何时运行

• 定期（每周或在重大变更后）
• 当被要求“审查”、“审计”或“检查”工作空间时
• 引导或重大重组之后
• 在心跳维护周期内

审查流程

1. 结构检查

验证预期文件存在于正确位置：

~/.openclaw/workspace/
├── AGENTS.md        ← Operating instructions (REQUIRED)
├── SOUL.md          ← Persona/tone (REQUIRED)
├── USER.md          ← User profile (REQUIRED)
├── IDENTITY.md      ← Agent name/vibe/emoji (REQUIRED)
├── TOOLS.md         ← Local tool notes (REQUIRED)
├── HEARTBEAT.md     ← Heartbeat checklist (optional)
├── MEMORY.md        ← Curated long-term memory (optional)
├── BOOT.md          ← Runs on gateway restart (optional, boot-md hook)
├── BOOTSTRAP.md     ← One-time first-run ritual (delete after use)
├── memory/          ← Daily logs + reference docs (vector-indexed)
│   └── YYYY-MM-DD.md
└── skills/          ← Workspace-specific skills (optional)

关于BOOT.md与BOOTSTRAP.md的说明：

• BOOT.md— 持久性；每次网关重启时运行（若boot-md钩子启用）
• BOOTSTRAP.md— 一次性；代理在首次运行时遵循它，然后将其删除

检查：运行ls -la于工作空间根目录。标记缺失的必要文件。

2. 文件用途审核

每个文件只有一项职责。检查是否存在范围蔓延：

检查：浏览每个文件。标记位置错误的内容。

3. 记忆维护

• 每日文件使用YYYY-MM-DD.md或YYYY-MM-DD-slug.md格式
• 钩子生成的会话文件（session-memory钩子创建YYYY-MM-DD-slug.md）需定期审查
• 参考文档使用描述性名称（而非日期）：project-notes.mdapi-guide.mdMEMORY.md 包含的是精心提炼的见解，而非原始日志
• MEMORY.md 和每日文件之间没有重复信息
• 旧的每日文件会定期审查并提炼到 MEMORY.md
• 内存文件中不包含敏感数据（如 API 密钥、密码）
• 自动内存刷新：

OpenClaw 在会话压缩前会触发一次静默代理轮转，以写入持久化记忆。代理会收到一个提示，将重要上下文刷新到memory/YYYY-MM-DD.md。这是自动进行的——无需任何操作，但请注意，在达到约 18 万令牌后，您的上下文将被压缩。4. 向量搜索对齐

默认情况下，只有

• MEMORY.md和memory/**/*.md文件会被索引每日日志使用
• YYYY-MM-DD.md格式；参考文档使用描述性名称在此范围之外的文件
• Files outside内存/可以通过config中的

memorySearch.extraPaths进行索引会话内存（实验性功能）：如果memorySearch.experimental.sessionMemory = true，会话转录内容也会被索引，并可通过

memory_search

进行搜索。

cd ~/.openclaw/workspace && git status

• 5. Git 状态
• ⚠️ 此工作空间为私有空间。切勿推送至 GitHub 或任何公共远程仓库。
• 未配置远程仓库（或仅配置了私有备份）
• 不存在应被跟踪的未跟踪文件
• 不存在应被 .gitignore 忽略的已跟踪文件不存在已搁置数日的未提交更改.gitignore 已排除密钥文件（*.key,

.pem, .env, secrets

）

ls -la ~/.openclaw/workspace/

6. 异常文件检查

• 重复引导文件目的（例如，README.md与AGENTS.md并存）
• 在工作区存储凭据（应存放在~/.openclaw/credentials/）
• 创建目的不明确的非标准目录

注意：仅MEMORY.md和memory/**/*.md文件会被向量索引。位于memory/目录外的文件可通过配置中的memorySearch.extraPaths添加。

7. 大小检查

引导文件应保持精简（每次会话都会加载）：

• AGENTS.md：理想<500行，最多<1000行
• SOUL.md：理想<200行
• USER.md：理想<100行
• IDENTITY.md：理想<50行
• HEARTBEAT.md：<100行（需考虑token消耗问题）

wc -l AGENTS.md SOUL.md USER.md IDENTITY.md HEARTBEAT.md TOOLS.md MEMORY.md 2>/dev/null

8. 技能检查

如果技能/存在：

• 每个技能都有一个包含有效前置元数据（名称、描述）的SKILL.md文件
• 没有重复的技能（工作区与托管版本之间）
• 技能遵循渐进式披露原则（精简的SKILL.md，详细内容通过引用提供）

输出格式

审查后，报告：

## Workspace Review — YYYY-MM-DD

### ✅ Passing
- [list what's correct]

### ⚠️ Warnings
- [list minor issues]

### ❌ Issues
- [list things that need fixing]

### 📋 Recommendations
- [specific actions to take]

参考文献

• references/openclaw-conventions.md— 完整的工作区文件规范
• references/checklist.md— 快速参考检查清单