什么是工作目录健康检测
工作目录健康检测是一套专为 OpenClaw 生态系统设计的自动化诊断与维护工具，旨在解决因工作目录嵌套或配置错误导致的系统异常问题。该工具通过智能扫描与校验机制，识别 `.openclawworkspace` 文件在项目结构中的递归嵌套现象，并验证当前工作路径是否符合预期配置。其核心设计围绕预防性维护展开，能够在问题影响开发流程前主动发现潜在风险点。用户可通过命令行触发检测、校验或修复操作，整个过程无需中断现有工作流程。工具特别适用于团队协作环境，确保所有成员使用统一且规范的工作目录结构。此外，脚本部署于 `E:\\.openclaw\\workspace\\scripts` 目录下，便于集成到 CI/CD 流程或本地开发环境中。
核心功能特点
- 自动检测 `.openclawworkspace` 文件的递归嵌套目录结构
- 全面校验配置文件与实际工作目录的一致性
- 支持演练模式预览修复操作，降低误操作风险
- 一键执行路径修复，自动清理无效嵌套并更新配置
适用场景
该工具最典型的应用场景是解决因手动复制项目或迁移环境导致的工作目录层级混乱问题。例如，当开发者将一个已存在 `.openclawworkspace` 的文件夹复制到新位置时，可能意外创建多层嵌套，引发 OpenClaw Gateway 启动失败或资源加载异常。此时运行 `detect-nested-workspace.ps1` 可快速定位问题根源，避免后续调试时间浪费。另一个高频场景是团队协作中不同成员使用不一致的路径配置，造成构建失败或数据同步错误。通过定期执行 `validate-workspace.ps1`，团队可保持目录结构标准化。对于运维人员而言，在批量部署或环境重置后，使用 `-DryRun:$false` 参数执行修复脚本能显著提升系统稳定性。尤其适合 DevOps 流程中作为前置检查环节，确保每次部署均基于健康的工作目录状态。