Workspace Review

🛡️ OpenClaw工作空间规范审计助手

system榜 #9

面向OpenClaw工作空间的自动化审计工具,通过8步检查流程确保文件结构、内存管理、向量索引符合规范,防止配置漂移和敏感数据泄露。

收藏
10.3k
安装
2.8k
版本
1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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.mdmemory/**/*.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/ 审计需访问用户历史日志,虽为本地操作但涉及敏感内容读取

Workspace Review 内容

暂无文件树

手动下载zip · 8.8 kB
contentapplication/octet-stream
请选择文件