检测并修复OpenClaw工作目录嵌套问题。
触发条件
用户提到以下任意关键词时激活:
- 工作目录异常
- 嵌套目录
- .openclawworkspace
- workspace问题
- 路径错误
- openclaw doctor
- openclaw init
- 工作目录健康
- 工作目录医生
功能
1. 检测嵌套目录
扫描 .openclawworkspace 递归嵌套目录
2. 校验工作目录
- 检查配置文件中的工作目录
- 检查当前工作目录
- 验证路径有效性
3. 修复功能(需用户确认)
- 删除嵌套目录
- 修复配置文件中的工作目录路径
- 支持演练模式(DryRun)
使用方法
方式一:在线使用(推荐)
-
访问 GitHub 仓库获取脚本: https://github.com/maxkandel99-arch/workspace-health
-
下载 scripts 目录下的脚本:
- detect-nested-workspace.ps1
- validate-workspace.ps1
- fix-nested-workspace.ps1
-
运行检测:
.\detect-nested-workspace.ps1
.\validate-workspace.ps1
.\fix-nested-workspace.ps1 -DryRun:$true # 演练模式
方式二:直接询问
直接告诉AI你的问题,如:
- "我的OpenClaw工作目录好像出问题了"
- "检测一下工作目录健康"
AI会引导你完成诊断和修复。
安全说明
- 修复操作前默认使用演练模式
- 删除操作前会提示用户确认
- 建议修复前备份配置文件
- 修复后需要重启OpenClaw Gateway
常见问题
Q: 什么是嵌套目录? A: 当OpenClaw的工作目录路径指向另一层workspace时,会形成嵌套,可能导致配置读取错误。
Q: 如何判断是否需要修复? A: 运行 validate-workspace.ps1 脚本,它会检测并报告问题。