核心用法
workspace-review 是一个系统性的工作空间自检技能,用于验证 OpenClaw 环境是否遵循官方约定。触发条件包括:用户明确要求"review workspace"、"audit files"、"check structure",或作为定期维护任务自动执行。
该技能执行 8 项结构化检查:
1. 结构检查:验证 ~/.openclaw/workspace/ 下 6 个必需文件(AGENTS.md、SOUL.md、USER.md、IDENTITY.md、TOOLS.md)及 3 个可选文件的存在性
2. 文件用途审计:对照矩阵检查每个文件是否"职责单一",防止范围蔓延
3. 内存卫生:确认日志命名格式(YYYY-MM-DD.md)、敏感数据隔离、自动内存刷新机制(~180k tokens 触发)
4. 向量搜索对齐:确保仅 MEMORY.md 和 memory/**/*.md 被索引
5. Git 状态:强制检查无公网远程、无敏感文件追踪、正确配置 .gitignore
6. 异常文件排查:识别重复用途文件(如 README.md)、凭证泄露、非标准目录
7. 体积检查:Bootstrap 文件行数上限(AGENTS.md <1000行,SOUL.md <200行等)
8. 技能检查:验证 skills/ 目录下 SKILL.md 格式、无重复技能
输出采用四级报告格式:✅ 通过、⚠️ 警告、❌ 问题、📋 建议。
显著优点
- 规范性强制:将 OpenClaw 的隐式约定转化为可执行的检查清单,降低新用户上手成本
- 敏感数据防护:内置多层检查(.gitignore 规则、凭证目录隔离、内存文件扫描)
- 性能意识:显式关注 token 消耗(自动内存刷新、文件行数限制)
- 渐进式技能设计:自身遵循所审计的原则——SKILL.md 精简,详情指向 references/
潜在局限
- 环境锁定:深度绑定 OpenClaw 特定目录结构和命名约定,无法直接迁移至其他框架
- 被动触发:依赖用户指令或外部调度,无内置定时任务机制
- 语义检查不足:仅能验证文件存在性和粗略内容分类,无法判断 AGENTS.md 中的指令逻辑是否正确
- 实验性功能覆盖不全:
sessionMemory等实验功能仅作提示,无深度审计规则
适合人群
- OpenClaw 长期用户:需维护数月历史的工作空间
- 多项目开发者:频繁切换 context,易遗留过期配置
- 团队协作场景:确保成员工作空间结构一致
- 安全意识较强用户:希望自动化排查凭证泄露风险
常规风险
- 误报风险:严格检查可能将合理的自定义扩展标记为"异常"
- 检查疲劳:8 步流程在大型工作空间上可能产生冗长输出
- 依赖维护:OpenClaw 约定迭代后,技能自身可能过时
- 隐私边界:
memory/审计需访问用户历史日志,虽为本地操作但涉及敏感内容读取